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i.o iMiaQaiiciiaB 



stands between the user and the machine •••** 

Harlan D. Hit Is 

The Software Engineering System (SES) provides task oriented or 
procedural access to a collection of iaCtaacfi Ifiais* running on the 
Network Operating System (NOS). An underlying philosophy of SES 
is s where there»s a function or task to be done* provide a 
PROCEDURE to do it. Programs are generally not used directly* 
rather they are accessed via SES procedures that provide a 
consistent access method. 

This SES User's Handbook is intended both as a tutorial 
introduction for new SES users (who should i3s£ioiifill read this 
chapter)* and also as a reference manual for experienced SES 
bashers. Although this is not the g.Qii existing relevant SES 
document* it's the main trunk of the tree of knowledge of H&ai ££S 
£BQCEBli&£S a**e available. Because this SES User's Handbook is 
usually updated only at SES Releases - a big deal - neus of new SES 
stuff appears In the TOOLS BULLETIN roughly every month* in various 
SES NEWS memos* and may even be passed by word of mouth. 

&2££s&£2 E£.&dU££i2Q covers many areas other than the narrow 
fields of "assemblers* compilers and loaders**. To cover the wider 
areas* we need good tools. SES provides the tools. This SES User f s 
Handbook is arranged in chapters that "cluster** around related 
functional areas (such as document formatting* file management* text 
processing and so on). This chapter (chapter 1) is a general 
introduction to the concepts of SES and its use. The remaining 
chapters of this handbook cover the functional areas. Below is a 
brief summary of the contents of the remaining chapters. 

A major proportion of SES is devoted to the CYBER 180 SIMULATED 
.,..,-.,„ ,__ ._ the CYBER 170. Chapter 9 contains 
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formatter* the documentation facilities* many of the text 
manipulation tools* and the source text maintenance utilities* 

Of course* Compilers* Assemblers and Loaders go. play a part in 
software production - Chapter 8 covers lots of useful goodies in 
this area* the most important being the CY8ER IMPLEMENTATION 
LANGUAGE - CYBIL. As well as a CY8IL compiler* Chapter 8 also 
describes CY8IL-CC INTERACTIVE OEBUG* a symbolic debug facility* 
based on CYBER Interactive Debug but oriented towards CYBIL code. 

Production of large lor small) software systems requires some 
means of MANAGING SOURCE TEXT so you don»t drown in nitpicking 
details* SES supplies a comprehensive collection of source text 
maintenance procedures geared up for the ASCII version of MODIFY 
(known as MADIFY) to manage CYBIL source text for you* or* in fact* 
any other ASCII source text* such as documents* data dictionaries* 
process descriptions and so on. These facilities are described in 
Chapter 4. Chapter 10 describes the NOS-170 version of the CYBER 
180 Source Code Utility (SCU)* There's also a set of procedures to 
make UPDATE easier to live with* described in Chapter 16* 

When you've compiled or assembled your source text of course 
there's the embarrassing question of OBJECT CODE MANAGEMENT. 
Chapter 5 covers LIBRARY MANAGEMENT - a collection of procedures 
that interface to the NOS LI8EDIT utility* These library management 
procedures can in fact handle all sorts of things other than just 
object code* 

One of the first hurdles to clear on most computer systems seems 
to involve the question "how do I print a file**? Chapter 2 shows 
that printing files really can be easy. 

An important part of software production involves DOCUMENTATION. 
SES has a collection of tools that make a fun job of generating 
beautiful documents. Documentation aids revolve around the TXTCODE 
document formatter* used to produce this Handbook* Chapter 3 covers 
document formatting. 

Preparing beautifully formatted source text for high level 
language processors is something you like to have* but you'd rather 
not do it yourself. Chapter 12 covers SOURCE TEXT PREPROCESSORS of 
various types* the most important from the SES viewpoint being 
CYBFQRM - the formatter for CYBIL. 

In any time sharing system* MANAGING FILES is an important part 
of life* as is FINDING OUT WHAT'S GOING ON. Chapter 6 relates to 
getting information* such as your files* limits* dayfile* while 
Chapter 7 covers the aspect of dumping your files to tape* and 
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hanging on to files you want to hang on to. 

An amazing amount of the daily job of software production 
involves massaging text in some way or another. Chapter 14 covers 
many aspects of TEXT MANIPULATION. Conversion of character sets 
tends to be a way of life rather than an infrequent exercise* and 
there are utilities to work well with the NOS version of ASCII* 

Software Production really is a community activity* and Chapter 
13 describes facilities for users to talk to each other via a mall 
system. 

SES PROCEDURES take care of the details of using software* such 
as locating* returning and rewinding files* obtaining required 
memory* obtaining required utility programs to perform tasks* and so 
on* leaving you free to specify what you want done. To state it 
briefly s 

YOU decide WHICH SES PROCEDURE you want to use for the job. 

SES generates the JOB CONTROL STATEMENTS to do the job. 

Using SES* you can run a procedure directly as part of your 
interactive session* or you can make many of the procedures run 
independently as batch jobs* 

Experienced* curious or masochistic users wishing the joy of 
creating their own gourmet SES procedures can read the SES Procedure 
Writer's Guide. 

At the end of this chapter there's a list of documents relevant 
to peaceful and productive coexistence with NOS. 

As you read this document* you'll notice that although many SES 
procedures have lots of parameters* most parameters are optional* 
For example* the PRINT and FORMAT procedures have* respectively* ten 
and eighteen parameters; 90£ of PRINT and FORMAT usage requires only 
one parameter. Finally* the usability, of SES results from people 
using it and feeding back their (constructive) criticisms* ideas for 
enhancements to existing facilities and ideas for new facilities* 
We hope you'll do the same. 

dfiifi s we strongly recommend that you read all of this 
introductory chapter (chapter 1) before reading other chapters. As 
you read this introduction* try using some of the SES procedures 
described in the examples as you go* Finally s 

When all else fails* read the documentation! 
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1.1 USING AN SES PROCEDURE 



1.1 U£IS£-4i3-$£S-ESJ3££!n!S£ 

Whether yoy use SES interactively* or run it in a batch job» the 
usage is the same* as shown here : 

ses. procedure. name I ist.of .parameter s 

the ses before the period starts the SES processor. The aexiaii *•* 
following £££ is r.e.auir.SJj to keep NOS happy. The statement directs 
the SES processor to locate the procedure given by procedure.naie* 
and when it has been located* to process that procedure and 
substitute the {optional) parameters given by I i st_of .parameters* 
and finally* execute the procedure either directly {"while you 
wait**) as part of your interactive session* or SUBMIT the procedure 
as an independent job. For example s 

ses. print bl ivet 

PRINTs file blivet on the ASCII printer* and : 

ses. count lines in grundge 

CQUNTs the number of lines in file grundge. 



1 . 2 £&RA!S£I£&i_E0a-££S-.EB{2£££mS£$ 

As mentioned above* you use an SES procedure by typing a 
statement of the form i 

ses .procedure. name I ist. of .parameters 

where 1 1st. of. parameters is the parameters required for that 
particular procedure. 

Parameters may be specified by &£xw.gxg> for example s 

ses.print f»myflle 

In this example* f is the parameter kfiY-Matd or parameter Qaofi* and 
myfile is the parameter y.aiU£* Generally* the name on the left of 
the equal sign is the parameter k£y_Uftr_d or parameter q&§£* while the 
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thing on the right of the equal sign is the parameter yaiyg. 

While parameters may be specified by keyword* it's also possible 
(and usually more convenient) to leave out the keyword and the equal 
sign and specify parameters B fts.it ifiQally.* This means that you don't 
have to type the keyword or the equal sign. For example s 

ses.copyacr infile* outfile* 3..79 

When keywords are usedt it doesn f t matter in what order you code the 
parameters* The use of CQPYACR above could have been coded s 

ses.copyacr o*outfile* 3. .79* i=infile 

however if you want to code parameters without using keywords* you 
must get them in the right order. 

When you use an SES procedure you can code parameters in a 
mixture of both positional ami keyword forms* whatever suits you. 

Every SES procedure expects its parameters in a specific order. 
When you code a parameter by keyword* you effectively "tab" the 
parameter number to that "position**. That's why* in the example 
above* we were able to code : 

o»outfile# 3«.79 

by coding o«outfile we "tabbed" the parameter to the second 
"position". The next parameter (coded without the keyword) was 
already in the third "position". But when we wanted to code the 
input file name we had to specify it by keyword in order to "tab" 
back to the first parameter position. 

Use of positional parameters sometimes leads to minor problems 
when what you think is a file name is in fact the keyword for a 
parameter. For example* many SES procedures have a parameter called 
group* which is the name of a group (or multi record) file. If you 
use a procedure such as COLLECT* for instance* like this s 

ses.collect (torn* dick* harry) group 
-TOO FEW VALUES GIVEN FOR PARAMETER- 

in this case* the error message actually means : you have coded a 
parameter kfiiMftJlSl* and not supplied a £&L\l& for that parameter* In 
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such cases* you have to sittifii: code group*group» Q£ code the 
positional value In string quotes s •group** 

Host SES procedures use short naiaes like i and f for parameter 
keywords* so it's best if you avoid single letter filenames. For 
example J 

ses.uptolow f 

will cause an error* because f is one of the keywords for the first 
parameter of UPTOLOW. You can either code the parameter as f»f* or 
code it as f f f » or use a name like grab or junk for the filename* 
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1.2.1 TYPES OF PARAMETER VALUES 



Values supplied for parameters may be QjaffifiS* oyibsui* or 
&liaLl££S£ sttiQas* These are described in detail here. 



1.2.1.1 &ate.s_,as-£a£aa£££x_¥aiii£.£ 

A BAME is from one to seven characters long. It iyafc start with 
a letter* and lay contain aalv. letters or digits. For example J 

A* ZQ91AP6* and CYBIL are valid names* whereas • 1AJ* input_file* 
and o versi zedname are invalid names according to the rules above. 
An example of using names in an SES procedure is * 

ses.uptolow i*hibrow* o*lowbrow 

for converting file hlbrow from upper case to lower case with the 
result appearing an file lowbrow. 



1.2.1.2 tiufflb£f.s-a£-£aiLa!a£t££_¥alU£s 

A !!UtlfiE& contains 2Qly. digits. The number may be followed by an 
optional BASE. For example : 

579(10) 1493 are DECIMAL NUMBERS* or numbers to the 

base 10. 

677181 1754(81 are OCTAL NUMBERS* or numbers to the 

base 8. 

0AF6U6) 3E8I16I are HEXADECIMAL NUMBERS* or numbers to 

the base 16. Note that hexadecimal 
numbers iiist begin with a decimal 
digit* even if you have to start them 
with a zero. This avoids a potential 
confusion of a hexadecimal number with 
a name. 
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1.2,1.2 Numbers as Parameter Values 



Numbers such as 6789C8) and 3A5(10> are disliked by SES. Use of 
nuflieric parameters occur in procedures like : 

ses. print copies»3» f»yinyang 

to print three <3) copies of file yinyang on the ASCII printer. 



1.2.1.3 £u^La£££X.S££iQa&.as.£££ai£££LJ2£iU£& 

A C.tiA&AC.IE& SI&I&& is any arbitrary string of characters enclosed 
in single quote signs (•)♦ If you wish to include a single quote 
sign In a string* you roust represent it by two quote signs in a 
row* For example 3 

•this is an example of a character string* 

'quote signs must be represented by two '• quote signs in a row* 

You use strings in SES procedures when you have to supply strange 
names such as SYM$SM* and when supplying sentences to procedures ? 

ses.genupcf d*'mcs$c30* 

when generating an update compile file* and t 

ses. I 1nkl70 binf He* xld«» ldset<usep«swlsys>subst*swlsy-$swlsy.l$H 

to give extra loader directives to LINK170. 
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1.2.2 RANGES OF PARAMETER VALUES 

Some SES procedures handle parameter values in the form of a 
&Ati£E» For instance* procedure CQPYACR has a parameter named cols* 
which represents a pair of column numbers* You can write the cols 
parameter In the form ? 

cols*3..65 

the pair of periods Is called an ELLIPSIS. The range specification 
consists of a law. side* on the left of the ellipsis* and a tliflfa sidfi 
on the right of the ellipsis. Another example of a procedure that 
accepts ranges is GENCOUP* which accepts ranges of module names* 
I ike this : 

ses.gencomp almaden. .bertero 
which refers to all modules almaden through bertero inclusive* and * 

ses. select lines 10. .20 of galloop 
to display lines 10 thru 20 of file galloop at the terminal. 
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1,2.3 LISTS OF VALUES FOR PARAMETERS 

Some SES procedures handle parameters consisting of many values. 
For instance* you can tell procedure PRINT to print a whole bunch of 
files* like this: 

ses. print f*(atlas* orion* mercury* pegasus* sirius* hemes) 

the value coded for the f parameter is called a ¥ALUE LISI* A value 
list lyst be enclosed In parentheses* as shown in the example* The 
individual items in a value list are called ELEttESIS of the list* 
and they are separated from each other by a comma* 

Elements in a value list can also be ranges s 

ses. select lines <1# 2» 3* 12. .17* 21. .25) of Midget 

An element of a value list may itself be another value list* For 
instance* procedure GENCOMP has a parameter called ab* which can be 
coded in the form s 

gencomp ab»C Cr I esl Ing* mondavi)* gamay* (chenin* wenteH 

to get alternate bases from other user's catalogs. Note that the 
first and second elements in each of the sublists are the filename 
and the users catalog name* respectively. The description of the 
GENCOMP procedure talks more about the ab parameter. Also see the 
note below* at the end of this description on parameter lists. 
Procedure ASORT uses lists of lists to indicate the columns for the 
sort keys : 

ses.asort i*ganip* o*ganop* keys»((l* 5)» (4* 7* dU 

Each sublist in the list above is a single sort key; the elements in 
the sublists are the start column* length* and direction of sort. 
See the description of the ASORT procedure for more information* 

If you code only one value for a parameter* you can leave the 
parentheses off* like this * 

ses. print f»myfile 

but as soon as you want to supply more than one value you must 
supply the parentheses* like this * 
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ses. print (bowmore* Jura* miltown) 

Such are called tylti lalus! £aLaffl££er.S> or y.alys lists* or just 
Plain IlStS. 

Referring to the discussion on the ab parameter of GENCOMP above* 
a few SES procedures handle parameters of that form* Those 
parameters are somewhat special forms for accessing files from other 
users 1 catalogs* for example* the LINK170 procedure uses this form 
for the list of libraries : 

ses.1inkl70 p«{< I i b.l* I ib_2*user..i) > I ib_3* C I ib_4» I ib_5*user_2 Jl 

each siaifiat in the outer parenthesised list is itself a list 
{possibly containing only one element) of libraries and the places 
to get them from. So* in this example* the fiisi sublist says * 
obtain Hb_l and Hb_2 from the catalog of user.l; the iscaail 
sublist has only aQ£ element* which means i obtain lib. 3 from the 
catalog of the current user; the t&i£d sublist says J obtain lib. 4 
and lib_5 from the catalog of user. 2* For procedures that use this 
form of parameter* the last element in each of the sublists is the 
user name of the catalog from whence to obtain the files* 
Conversely s 

ses.linkl70 p»Uib_l* Hb_2» lib. 3* iib_4* lib. 5) 

means i obtain all five library files from the catalog of the 
current user. 
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1.2.4 PARAMETER LISTS AS PARAMETER VALUES 

Some SES procedures handle multi valued parameters which are 
themselves parameter lists to foe passed on to other procedures* for 
instance* procedure FORMAT has a parameter called print* which is 
actually the parameters for the PRINT procedure* used by FORMAT in 
the course of its run* You code the print parameter of FORMAT like 
this : 

ses. format nyfile* print*c*2 

ses.format hisfile* pr int s <c*5*h*' final ers'l 



1.2.5 PARAMETER KEYWORDS AS PROCEDURE OPTIONS 



Some SES procedures have parameters that don't want any values at 
all. In these cases* the parameter fcfiy.MQr.Jl is used to indicate 
Q £11 QMS for the procedure. For instance, procedure PRINT has a 
shift fcay. (no pun intended)* which if coded* indicates that the file 
to be printed has not been formatted for a line printer and must 
therefore be "shifted** to the right by 1 column and have carriage 
control characters added In <the new) first column* You use PRINT 
i n such a case like : 

ses.pr int f»anyf i le* shift 

and another example of ootions is GENCQMP tGENerate COMPile file)* 
where you can type s 

ses.gencomp ail* b*cidbase* cf*comfiie 

In this case* the all &£* indicates that ALL modules are to appear 
on the resulting "compile file**. 

Throughout the procedure descriptions* we use the word fifiy. to 
mean a keyword used to provide options to a procedure* 
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1 . 3 USI!Jfi-aaE£-.IidA^-QM£-S£i.£aQC£QyE£-iI-4-IIII£ 

It's possible to use many SES procedures* each one following on 
right after the previous ones with no execution breaks between 
them. You do this by coding them all on the same line* each 
procedure terminated by a semicolon* like this * 

ses. print myfile* noshift; print hisfile shift! catlist 

This example PRINTs myfile and doesn't shift it (the noshift &£*>* 
PRINTs hisfile with carriage control added (the shift &£¥.)* and 
finally does a CATLIST of your files for you. 



1 • 4 fl&flUHi&X.CQt!I&QL-SIAIEtt£tlIS-Qli-A.CALL-Ifl-SES 

It's also possible to include regular NOS control statements on 
the sane line as SES procedure calls* all mixed together* like 
this s 

ses. print myfile; f r eturn*myf i I e* ; • get»hisf i le f * format hisfile 

As you can see* the ordinary NOS control statements are enclosed in 

string delimiters just like any other character string. When SES 

processes one of these control statement strings* it follows the 
rule that s 

if the string doesn't contain a period or a close parenthesis* a 
period is appended to the string* otherwise the string is left 
alone* 

This means that you can place NOS control statements such as GTR 
and MODIFY (which use the control statement comment field for 
directives) with no problems* For example * 

ses. • attach* pi ocr ib» ; • gtr*plocr i b»f red*** ; print fred 

In this example* the second NOS control statement* namely the GTR* 
has a period in it* so SES doesn't place any period at the end of 
the string* whereas SES dge.£ place a period at the end of the first 
string (the ATTACH statement). 
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i*5 CONTINUING SJS STATEMENTS^OVER MORE THAN ONE LINE 

1 . 5 aQMIIHyiMa.S£S.iIAI£d£iIS-l3^£E«l30S£-I!i4M«QM£«LIIi£ 




/ses. print f*<snark» shark* charmed* quarks* •• 
• •? larks* boojums* grogs* bander* snatchi) 

After you f ve signalled the incomplete line by placing an ellipsis at 
the end of the line* SES prompts for a continuation line *#ith a ••? 
at the start of each continuation line. The slash (/) before the 
ses on the first line indicates where NOS outputs lis prompt for 
commands • 



When you use SES in a batch job stream you simply code the 
continuation lines one after the other* each incomplete line having 
the ellipsis at the end* for example ? 

batch 
job 

statements 
SES. COLLECT CCHENAS* ELEURIE* MORGON* CORNAS* TAVEL* .. 
GHENNEf SOAVE* QRVIETOt CAREHA, PARRINA* BAROLOI 
and more 

batch 
job 

statements 
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1 . 6 £&Q£ILE-=-i£IIIIifi-UE-IQyB-LaCAL.EtiHiaQtlll£llI 

A PROFILE Is a file where you can place information about you and 
the things you»re currently working on* Many SES procedures use 
information out of the PROFILE to set up defaults for frequently 
used things* such as the name of an object library* Having a 
PROFILE can save you much time since you don't have to code 
parameters for information that f s already in the profile. 

If you want to have a profile* you should create a file called 
PROFILE which has the word PROFILE as the first line of the file* 
The most important and useful pieces of information to place in your 
profile are your Eassw.oxji* CtUtafi QUlfcfir, and ££Q.i££t QUafcex. Thus, 
your initial profile should have (at least) the following in its 

PROFILE 

\ passwor * 'your .password 1 

\ charge • •your.charge.number • 

\ project ■ • your .project. number • 

An sasi way to set up an initial PROFILE for yourself is to call 
the BuiLD PRQFile (£U*£RQ£> procedure like this s 

ses.bldprof 

BLDPROF prompts you for the most common items to be placed in your 
profile* In addition* it creates a MAILBOX for you* For 
information on the "mail** facilities of SES* see chapter 12*0 - 
•USER TO USER COMMUNICATIONS*. 

SES supplies a procedure called IAF* which sets up defaults for 
particular terminal types. BLDPROF prompts for your terminal type* 
and places that information in your profile. For further 
information on IAF* see the IAF procedure description in the 
"miscellaneous useful goodies" chapter. 

BLDPROF will also ask you for your graphics terminal type which 
may be different than your usual terminal. Even if you use the same 
terminal for graphic CCADSG) and non-graphic work* you should answer 
both requests* BLDPROF will ask additional questions about your 
graphics terminal - baud rate* hard copy available* and for 
TEKTRONIX 4014 Extended Graphics Module and synchronous or 
asynchronous* For further information on CADSG* see the CADSG 
procedure description in the Structured Process Tools chapter. 

There are many other things that may go Into your profile. These 
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are mainly concerned with source code maintenance and library 
management functions and so on* These other aspects of profiles are 
discussed in the chapters dealing with the specific subjects* 

Another useful thing that can go into a profile Is SES directives 
that specify which procedure libraries* and where* to search for 
procedures. The SEARCH directive is discussed in appendix A. 
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1.7 s£S-£fiQCEQug£s.suiiius-aAiati.iaas 

Instead of running interactively* or "while you wait* at your 
terminal* many SES procedures can be submitted to run in the 
background as batch jobs* You do this by coding a k&x (batch or 
batchn or defer) which causes the framework of a batch job to be 
built around the specified procedure* then SUBMITS the file so built 
to NOS as a batch job* 

Using SES in this way is often very effective* especially where 
the job to be done uses lots of resources* By running the job in 
batch* you can proceed with your interactive session instead of 
having to wait* 

for such procedures* the list of parameters described below are 
those which affect the running of the batch job* Note that these 
parameters are aQly. applicable if you run the procedure in batch 
mode {that is* non-local)* 



jobun 



jobpw 



jobf ml y 



{optional) JOB User Name to be used on the USER statement 
of the batch job* If you don't code the jobun parameter* 
the job is built with the user name of the current user* 
£LaiS s that in some NOS sites* it is aat Eassifcifi to 
SUBIilT a job to run under another user's account* The so 
called "secondary user 1 * statment is disabled* If 
secondary user statements are disabled* and you try to 
submit a job for another account* you get lafla&d &££* 



{optional) JOB Password to be used on the USER statement 
of the batch job* If you don't code the jobpw parameter* 
and there's no passwor variable defined in your profile 
{see the section on profiles!* SES asks you for your 
password in a similar manner to that of NOS* 



{optional) JOB FaMilY to be used on the USER statement of 
the batch job* If you don't code the jobfmly parameter* 
and there's no family variable defined in your profile 
{see the section on profiles)* the family name for the 
current user is used* 
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jobcn s 



jobpn 



jobf I 



jobtl 



jobpr : 



bin 



{optional) JOB Charge Number to be used on the CHARGE 
statement of the batch job* If you don't code the jobcn 
parameter* and there's no charge variable defined in your 
profile (see the section on profiles)* SES asks you for 
your charge number* 



(optional) JOB Project Number to be used on the CHARGE 
statement of the batch job* If you don't code the jobpn 
parameter* and there's no project variable defined in your 
profile (see the section on profiles)* SES asks you for 
your project number* 



(optional) specifies the JOB Field Length to be used for 
running the job* You don't normally need to code the 
jobff parameter* since all the procedures which run in 
batch set the Ft to the required value* If you want to 
specify the job field length as an acial number* you must 
add the C8) suffix to the number* because SES treats 
numbers as decimal unless told otherwise* 



(optional) specifies the JOB Time Limit to be used for the 
job» This is always the same for ail procedures* namely 
2000(8)* If you need more time for the job* you must code 
some value for the jobtl parameter. If you want to 
specify the job time limit as an o.££ai number* you lust 
add the (8) suffix to the number* because SES treats 
numbers as decimal unless told otherwise* 



(optional) specifies the JOB PRIority (that is* the P 
parameter on the NOS job statement)* If you want to 
specify the job priority as an ae.la.1 number* you lust add 
the (8) suffix to the number* because SES treats numbers 
as decimal unless told otherwise* 



(optional) filtl number parameter used at Sunnyvale 
Development Division to indicate which "bin" the job output 
should go in* The bin parameter is coded in the form of a 
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string* for example s bin«*7h , « You can also define a 
userbin variable in your PROFILE (see the section on 
profiles)* so that the bin number is picked up 
automatically* SES generates a large print banner of your 
bin number on the front of the job output* and also places 
the bin number in the job name field of the job statement* 
If you don't code the bin parameter* and there's no userbin 
variable defined in your profile* SES generates a bin 
number of NO-ID* which almost certainly guarntees that your 
job output ends up in the NOS/w*0 BIN NUMBER bin* 

focal or batch or batchn or defer : 

coding one of these (optional) keys determines the mode in 
which the procedure or job is to be run* Coding the local 
&ay. runs the procedure LOCAL to your terminal* or while 
you wait* Coding the batch fcfiy. issues a SUBMIT with 
option B for the SUBMIT statement* Coding the batchn &££ 
issues a SUBMIT with the N option for the SUBMIT 
statement* Coding the defer fc&y. DEFERS the job for after 
hours running* You can find all the gory details of the B 
and N parameters for SUBMIT in the NOS reference manual* 

nodayf or dayfile or df : 

this (optional) parameter applies to some of the 
procedures that can be run as batch jobs* Each procedure 
description (for procedures which can run as batch jobs) 
specifically mentions this parameter only if the procedure 
makes use of it* For those procedures that do use it* 
this parameter applies only if the procedure is run as a 
batch job (that is* non-local)* If you don't code the 
parameter at all* or if you simply code dayfile or df* if 
the job hits an EXIT statement due to errors* the job 
dayfile is dumped to a file called dayfile* which is 
placed in your catalog when the job terminates* If you 
code dayf i le*f i lename or df «f i lename* the dayfile is 
placed in your catalog in a file of name filename* If you 
code the nodayf option* no dayfile is produced at job 
end* The diagram below provides a more graphical 
explanation of the interactions of the dayfile parameter* 
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1.7 SES PROCEDURES RUN AS 8ATCH JOBS 



£L£££dli££ 



Astiaa Iafcsa 



lothing 



Job dayfile is dumped to file dayfile if any ! 
errors occur during the job* J 



dayf i le 

df fcfi* 
onl y 



or 



Job dayfile dumped to file dayfile If any ? 
errors occur during the job. I 



* dayf ile»f He. name 
" or df«f i le.name 



Job dayfile dumped to file file. name if any * 
errors occur during the job. } 



nodayf lie.* 



Job dayfile is qo.£ dumped even if errors t 

occur during the job* * 

— _«.«., — . . — . , , . „— 4. 



fiiatfi 5 that only those procedures whose descriptions contain a 
reference to the parameters described above can be run as batch 
jobs* 



Example of Batch Usage 



A fairly widely used SES procedure is LISTHOD (which suppl i es a 
cross reference and a printout of the modules in a base - see the 
chapter relating to source text maintenance). LISTHOD runs "while 
you wait*' by default* and since it grinds* it*s much better to run 
1 1 batch* I ike this t 

ses* listmod b«newdata> batch 

15.00.19. SUBMIT COMPLETE. JOBNAME IS AFTQBXT 
* JOB LISTMOD SUBMITTED 

This example shows a simple usage of LISTMOD run in batch by coding 
the batch &e.y.* The example assumes that your password* charge 
number* project number and all are defined in your PROFILE as 
described earlier* The message Is returned by NOS s it f s the time 
of day that your job was submitted* and the so called job name* The 
last message about job submitted comes from SES* 
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1.7.1 PROFILE VARIABLES FOR CONTROLLING BATCH MODE 



SES procedures that can optionally run In batch mode may be 
controlled by the settings of certain variables in your PROFILE* 
This makes it easier to use SES all round* since you don»t then have 
to supply the information every time you use a procedure. The set 
of diL££ti*£i below can be coded into your profile if you wish. 



PROFILE 

\ passwor » f your_password f 

\ charge » «your_charge_number * 

\ project * *your_pro ject_ number * 

\ family « •your.f ami I y 1 

passwor defines your password 

charge defines your charge number. 

project defines your project number. 

family defines your family name. 

tldtfi s that if your validation on the system is such that you do 
not require a CHARGE statement In batch jobs or when you log in at a 
terminal* you should set the charge and project variables to null 
(empty) strings. This inhibits the generation of the CHARGE 
statement by SES for batch jobs. 
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Examples of PROFILES 

PROFILE 

\ passwor * »ASTERIX* 

\ charge » f OB€LIX f 

\ project « »GETAFIX» 

That is an example of a minimal PROFILE* Here's a typical PROFILE 
as it wight be defined for a user at Sunnyvale Development 
D I vl si on s 



PROFILE 

\ passwor * 'WABBIT' 

\ charge » ff 

\ project * •• 

\ user bin » • 21E f 

\ myname * 'Lorenzo Desmondo ,f Hare f 

Note that the charge and project variables are set to empty strings 
- at the time of writing* SDD doesn't require CHARGE statements on 

NOS. 
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1.8 INFORMATIVE MESSAGES FROM SES PROCEDURES 



1 . 8 IB£QgMm£-i!S£S$A£££-E&aH-££i-£RQC£aUa£$ 



Many SES procedures are set up such that when they run "while 
waft** at the terminal* they output informative messages to tell 
what they're doing. The informative messages 
and QflfflSfl lifiY.a on the appropriate procedures* 
in the absence of any other information is 
output informative messages* Coding the nomsg 
messages. However* it is possible to establish your own default by 
defining a profile variable called msgctrl. The msgctrl variable 
can be defined In one of two ways * 



you 
you 

are controlled by 81SS 

The nor-nal default* 

for the procedures to 

fcsy. suppresses the 



\ msgctrl « •*• 



this sets the normal default for informative 
messages to no messages. In order to obtain 
messages from procedures the msg &e.y. must be 
coded on the procedure call. 



\ msgctrl « »SESMSG.*« 



this sets the normal default to output 
informative messages* To turn messages off* 
the nomsg &e.y. must be coded on the procedure 
c a I I . 



The table below should give a more graphical idea of the 
interactions of the msgctrl variable and the msg and nomsg kfiy.5 on 
the procedures. 



♦ «. — _™ «.«., — —, -.4. 

J Q££IB£D m £R££Ii£ J 

4 4* + — ™ + . + 

? Cadfid OH !! Nothing S \ MSGCTRL** SESMSG.*' S \ MSGCTRL*'*' J 

> Ecaasduiis : i ! J s 

+ — _ +* + — + ♦ 

J Nothing 5! Messages ! Messages * No Messages • 

+ +4..; — , — , 4. +, , , 4. 

! MSG «t Messages * Messages * Messages ' 

4. 4.4. . — , 4 ._, 4. 4. 

J NOMSG ' S No ! No Messages * No Messages I 
\ JS Messages \ 1 ! 

4. . 44 4. . , + , 4 
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1.0 INTRODUCTION 

1.9 GENERAL NOTES ON SES PROCEDURES 



1 . 9 ££fci£R4L-tiQI£S_QM_iEa..eaG££aURES 

SES procedures are* in general* written to do the detail work for 
you* so you can concentrate on the job at hand* let f s look at the 
workings of a typical SES procedure - £fl£X ASCII £oded Record 
(COPYACR)* to see what it does s 

ses.copyacr i»lni>ut.f i le* o*output.f i le 

* END COPYACR INPUT.FILE -> OUTPUT.FILE 

The COPYACR procedure emits NOS control statements to do the 
f ol I owing s 

acaiiiLa the input.fi le {see the note on ACQUIRE below) 

&£3Ui£S the Program (tool) that does the COPYACR process 

££tiiLQ the output.fi le 

(LQEXACL& from input. file to output.fi le 

LfitULQ the COPYACR program 

LfiHLQd both the input.fi le and the output.fi le 

you may if you wish* use procedures such as COPYACR like this $ 

ses.copyacr f 1 1 e_to_be.processed 

* END COPYACR FILE.TQ.BE.PROCESSED 

In such cases* where does the output of the procedure go? Well It 
certainly doesn't go to file output (the terminal). In such cases* 
the output file eventually replaces the input file : 

a&aillLfi the file. to. be. processed 
3fiauif.fi the COPYACR program (tool) 

CQfiXACS fi le.to.be. processed to a un igue.named.temp.fi I e 
££tU£Q the COPYACR program 
* LfiflaiBS f i I e. to. be. processed * unl que. named. temp.f i 1 e 
L&UiQd unl que.named. temp.f i le 

There are many SES procedures that function this way - they are 

often referred to as FILTERS - a process that copies an input to an 

output with some (one would hope* useful) transformation in 
between* 
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1.9 GENERAL NOTES ON SES PROCEDURES 



yhen you call up an SES procedure to : 

ses.do_some_process I * i nput.f i I e* o»output_f 1 1 e 

one of the control statements emitted by the procedure is a 
statement to ACQUIRE the lnput_file# which means s 

1. If there's a L3£AL file of the required name* SEMI&D that file 
and use it as the input_file. 

2. otherwise AIIACli or ££I a permanent file of the required name 
from the current user's catalog. 

Ail this means you don't have to care whether or not files are 
local - SES procedures grab whatever is available under that name - 
that is what ACQUIRE is all about. There is a full description of 
the ACQUIRE utility in Appendix E. 

The foregoing has some interesting effects which you should be 
aware of however. Consider the following sequence : 

ses.files; catlist 

WORK... ...12 PT. 

CATLIST Of WCN I 9 FILES* 2685 PRUS I 
HAIL8QX I SP A ...1 OLOUSER D PUR 1127 PNTSORS D PU R .105 
PR0CLI8 SP R .124 PROFILE I PR R ...1 PROGLIB PU R .835 
SEVEN.. I PU R ...2 STATSES D PU W .485 USERDIR I PU R ...5 

* END CATLIST 

ses.pack i*statses 

* END PACK STATSES 

ses.fi les 
WORK... ...12 PT. STATSES ..481 LO. 

* END FILES 

Note that we PACKed file STATSES. Note that originally* STATSES 
was a PERMANENT DIRECT ACCESS file. By the time the PACK process 
finished howevert the PACK procedure (because of the RENAME process 
described earlier) has now left a LOCAL file of the same name. SES 
procedures don't* in general* rewrite permanent files* Those that 
do say so explicitly. 
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1.9 GENERAL NOTES ON SES PROCEDURES 



Usiafl_SES_ELas£iJU£e.&-ia-Ia££& 



If you followed the description of the behavior of SES procedures 
above* you may take note that SES is designed primarily as an 
I!iI£R&£II¥£ tool. You £aQ use SES in batch job streams if you wish* 
but you should be aware that SES procedures don't* in general* make 
a special case of files ItSEUI and OUIEUI* whereas NOS dp.£S make a 
special case of files IMEUI and QillEUI* Usually* when using SES 
procedures interactively* you don't use QUIEUI as the output file 
from procedures* those procedures that £fi use IMEUI or QUIEUI say 
so* and take special note of those files* All this means that if 
you run SES in batch streams* and use files I&EUI or QUIEUI as input 
or output to procedures* you're likely to lose a lot of output 
because SES procedures EEilfcJQ or EEIUEti things* So* to avoid grief* 
uses files other than XtiEUI and QUIEUI* 



Uaigu&-tiai£&-iu_££&.EL&££dyL££& 

When SES builds the JCL stream from an SES procedure* programs* 
scratch files and so on are usually given unique names* so that you 
don't have to care which names are reserved by each particular 
procedure* These SES generated unique names are always seven 
characters long* always begin with the letters ZQ* and are always 
guaranteed to be different from the name of any file currently 
assigned to the running job* This note is for your information* 
Just in case you ever look at a dayfile where SES procedures have 
been used* and see lots of funny looking names* The example below 
shows the JCL generated by the ses.limits procedure* 

$RFLf20000> 

$IF( FILE! OUTPUT* ASH SRENAMEf ZQWT8Q6-OUTPUT I 

$ASSIGN(MS, OUTPUT) 

SLINITS. 

$RENANEfZQWT8QQ*aUTPUT> 

$IFtFILECZQWT8Q6.AS))$RENAHEI0UTPUT»ZQWT8Q6) 

$REWIND«ZQWT8RA> 

EDTCZQWT8QQtZQWT8RAfZQWT8RW} 

$RETURN<ZQWT8RA»ZQWT8RWf 

$C0PYBRCZQtfT8QQ# OUTPUT! 

$RETURNCZQWT8QQI 

SRFLCOI 

* END LIHITS 
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1,10 PROCEDURE DESCRIPTION CONVENTIONS 



The remaining chapters of this handbook describe SES procedures 

that are currently available. Each procedure description contains a 

list of parameter descriptions; and the order in which the 

parameters are described specifies their positional significance 
within the procedure. 

Only those procedures that wake reference* in their parameter 
lists* to the "batch job parameters - * (see section 1.7 - W SES 
PROCEDURES RUN AS BATCH JOBS") can in fact be run as batch jobs. 

If a procedure description does not contain a description for a 
parameter* that procedure does not have such a parameter. 

If a parameter description does not explicitly specify that a 
parameter is optional then the parameter must be supplied when the 
procedure is called. 

In order to reduce redundancy within procedure descriptions* some 
of the features provided by a procedure are discussed in the 
descriptions of particular parameters; therefore* we strongly 
recommend that when you read a procedure description* you read the 
whole thing. 

Before you read a particular procedure description* we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptions* profile usage* and naming conventions are 
discussed in those subsections. 
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1.11 HELP HODE 



l.U BELE-SOQE 



SES provides a mode of operation of procedures that produces 
descriptive information about the specified procedure* The 
information includes a one or two sentence description of what the 
procedure does plus a list of the parameters* their defaults* and 
the permissable values* In addition* required parameters are 
"flagged 1 * with <R> and defaults that are controllable by PROFILE 
variables are "flagged" with an ** To get the help documentation 
for a procedure listed out on your terminal* you simply type : 

ses* he I p*pr ocedure_name 

Notice that no parameters are given* SES responds by displaying the 
help documentation for the named procedure tif any is available)* 
For example s 

ses»help*cybi I 
produces s 

CYBIL compiles CYBIL source using either the CC or CI compiler* 



Parameters are: 

«._.»D ADAMCTCD -. —. 






___At 1 flU Alii C II At IICIC1.«. 


""""rAKAnt I tK" 

i*f 




CQHPILE 


— — ALLUtf AbLt VALutljl— — 

f i lename 


1 




LISTING 


f i lename 


b 




LGO 


f i lename 


cc.ci 




*CC»SES 


keyword»username 


chk 




N*R*S 


n»r»s or no 


lo 




I 


c*f*o*i*m»w*r 


debug* d*nodebug 


NOOEBUG 


keyword or CSTtOSl 


pad 




none 


1 •• large reasonable number 


opt 







or 1 (CI only) 


msg*no»sg 




*HSG 


keyword 


-HELP FOR CYBIL 


ON FILE 


OUTPUT- 





Hfitfi * that help mode is not intended as a training mechanism or 
a tutorial for new SES users - that*s what this SES User's Handbook 



is for - help 
experienced SES 



mode is 
hackers* 



there as a 



memory jogger 



for 



more 
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1.12 PRE-RELEASE VERSIONS OF TOOLS 



1.12 EBEr&ELEASE-iERilQliS-QE-IOQLS 

SES provides a convenient and consistent method for accessing 
pre-release versions of SES supplied tools* To access the 
pre-release version of a procedure* you simply type * 

ses»sss*procedur e_name I ist.of ^parameters 

If there is a pre-release available for the specified tool* it 
executes. If there is no pre-release version* you get the standard 
release version* 

If you always want pre-release versions of tools that are 
available* you can place in your PROFILE the following directive s 

\ SEARCH* USER* SSS* SESUNAM 

This tells SES to first look in the current user's catalog for the 
specified procedure {just as normally happens)* then look in the 
pre-release catalog (SSS)* and finally look in the standard release 
catalog (specified by the SESUNAH variable)* 

A more detailed description of the SEARCH directive can be found 
In appendix A* 
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1.13 PROBLEM REPORTING 



1.13 ERaaUH..&££QSII!J£ 

Problems encountered while using a released SES tool should be 
reported using a PSR {Programming System Report* COC form AA1901). 

Problems encountered while using a ore-released SES tool should 
be reported using a PTR {Programming Trouble Report* COC form 
AA3385). 

In both cases the completed form along with all support materials 
should be sent to the Arden Hills PSR Coordinator CARH273). 
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1.14 APPLICABLE DOCUHENTS 



1.14 AEELICAaL£-QQCUflEHIS 



The following Is a list of documents describing the various tools 
supplied by SES* Jlfltft s that SES provides a procedure called 
TOOLDQC which provides "on-line" access to many SES documents. If 
you call toolooc aiiuayt aiy.iaa au£ EaLaffiSt£r.£» you get a list of 
the available DCS documents* 



♦ — 



J Ver 

>+ 



+ — , — _«._, — .4. 

5 Updated 5 

+ + 

07/31/81 
05/29/79 



Tool 



Document Type I DCS Number 



SES 

SES 

EOT 

ACQU 

EXTR 

SESM 

TXTC 

TXTF 

TXTH 

GENR 

CADS 

CADS 

CYBI 

CYBI 

CYBI 

CYBI 

CYBI 

Si m. 

C180 

C180 

SES 

SES 

C070 

C180 

PSEU 

SCU 



Tool s 
Processor 

IRE 

ACT 

SG 

ODE 

ORM 

EAD 

EVP 
DD Tool 
Graphic 

L 

L 

L 

I 

L 



Tool 



Formatter 
Debugger 
I/O 
SOS/VE I/O 
CPU As Mb. 
PPU Asmb. 
VE Linker 
VE Generator 
QCU 

Slmul ator 
DO 
(170) 



• — «.-. * 


J 1. 


I J 


? 2* 


J 


; 1, 


5 J 


1 1* 


! 


5 1« 


\ 


3 2, 


? 


! 2, 


! 


\ 0, 


,0 S 


I 1. 


J 


5 1, 


J 


J 1, 


► J 


3 2, 


2 ; 


! 2, 


.4 j 


i 1, 


1 ; 


\ 2, 


.0 s 


1 5, 


,0 j 


; 3, 


,0 ; 


J 1« 


,0 J 



Use 
Use 
See 
See 
See 
See 
Use 
ERS 
See 
See 
Use 
Use 
Lan 
I.D 
ERS 
ERS 
ERS 
ERS 
ERS 
ERS 
ERS 
ERS 
ERS 
ERS 
Use 
ERS 



r Handbook 
r Guide 

SES U.H. 

SES U.H. 

SES U.H. 

SES U.H. 
r Guide 

SES U.H. 

SES U.H. 
r Handbook 
r Handbook 
guage Spec 
. Handbook 



r Guide 



ARH 1833 
ARH 2894 



ARH 2893 
ARH 1737 



ARH 

ARH 

ARH 

ARH 

ARH 

ARH 

ARH 

ARH 

ARH 

S250 

ARH 

ARH 

ARH 

ARH 

ARH 

ARH 



3980 

3981 

2298 

3078 

2619 

3142 

2739 

3125 

1693 

1 

2816 

2591 

2922 

1729 

2892 

1766 



02/21/80 
06/01/77 



03 
03 
06 
06 
05 
09 
07 
01 
02 
03 
02 
02 
07 
03 
05 
05 



/30/81 
/30/81 
/18/81 
/18/81 
/14/81 
/29/80 
/18/80 
/25/80 
/18/80 
/07/78 
/18/80 
/18/80 
/18/81 
/02/81 
/29/79 
/21/80 



SES U.H. 
SES P.W.G. 



refers to this document 



refers to the SES 
to above as the SES 



Procedure writer's Guide (referred 
Processor User Guide — ARH 2894) 
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1.0 INTRODUCTION 

1.1* APPLICABLE DOCUMENTS 



The following CDC manuals for NOS/170 may be of help to users o 
SES. 



60*35400 NOS Version 1 Reference Manual (Volume 1) 

60*45300 NOS Version 1 Reference Manual (Volume 21 

60455250 Network Products Interactive Facility Version 1 
Reference Manual 

60435500 NOS Version 1 Time-Sharing User's Reference Manual 

60450100 NOS Version 1 Modify Reference Manual 

60492600 COMPASS Version 3 Reference Manual 

60328800 SYMPL Reference Manual 

60497800 FORTRAN Extended Version 4 Reference Manual 

60429800 CYBER Loader Version 1 Reference Manual 

60481400 CYBER Interactive Debug Version 1 Reference Manual 
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2,0 PRINTING FILES 



2.0 £EIBIIfcUi-EIL£$ 



This section covers the facilities for printing files* Most of 

the discussion revolves around the ASCII printer* and the SES 

procedures to use the ASCII printer are as described below s 

PRINT prints fileCs) on the ASCII printer {the "normal" COC 

printer is an option). If necessary* "carriage control" is 

added to the files before printing (it is possible to 

override this automatic determination but it Is very seldom 

necessary to do so). Choices of character sets {full ASCII 

or the 6^ character ASCII subset) are available* 



PRINTID places "large print" heading banners at the start of a 
printout. Lines of title* date and time formats* and 
number of banners are selectable* PRINTID is used by PRINT 
to (optionally) place large print banners at the start of 
the file(s) to be printed* 

CQPYSAF £Q£Y. Shifted ASCII £i le. Copies an ASCII file to prepare 
It for printing at a later stage* The file is "shifted" if 
necessary. Character set conversion is also performed as 
requi red. 

BANNER place "large print" banners of your bin number on the front 
of a printout. BANNER Is used at Sunnyvale development 
division where output is placed in "bins"* identified by a 
bin number. 
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2.1 aaitii-=.e^iiii-£iL£iai 

PRINT is a powerful facility for printing one or more fiie(s). 
It looks after the mundane matters of character set conversions* 
special disposition (route) codes and* perhaps most importantly* 
automatically determining whether each file to be printed has 
already been or needs to be '•formatted'* for a printer. 

f or I i 

specifies the name of the File* or a list of files to be 
printed. If the file(s) are not already local when PRINT 
is called, PRINT tries to GET or ATTACH the filers) for 
you. 

copies or c or n * 

(optional) specifies the Number of Copies of the printout 
you require* If you don't code the c parameter* PRINT 
produces 1 lone) copy. 

h or Id J 

(optional) specifies the Heading banner to be printed at 

the start of your printout. If you don't code the h 

parameter* the first two pages of the printout will have a 

"large print" banner of the file name* date and time. 

hn or Idn s 

(optional) specifies the Number of Heading banners to be 
placed at the start of the printout. If you don't code 
the hn parameter* PRINT produces 2 (two) heading banners. 

shn or sidn : 

(optional) this parameter is used when printing more than 
one file at a time. When a list of files is printed* 
PRINT outputs a heading banner for the whole printout, and 
places a sub heading before each new file is started. The 
shn parameter specifies the Number of SubHeading banners 
to be printed before each new file. If you don't code the 
shn parameter* PRINT produces 2 (two) subheading banners. 

printer or pr ' 

this (optional) parameter specifies on which printer the 
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2.0 PRINTING FILES 

2.1 PRINT - PRINT FILE(S) 



printout is to appear* If you don't code this parameter 
or if you specify ascii* the printout is routed to the 
full ASCII printer. If you specify a&£ii&&* the printout 
is routed to 64 character ASCII subset printer. If you 
specify £j|a» the printout is routed to a "normal" CDC 
printer. Any other value for this parameter is illegal* 



bin : 



setid 



If you live at Sunnyvale Development Division* printout 
needs some sort of a banner containing a &ia Muafcex* to 
tell operations which fcio to place the output in. 
Printouts without a bin number frequently en6 up in a bin 
labelled N0S/W0 BIN NUMBER. At the time of writing* all 
bins have Identifiers of the form aHait diflit lfiiisn* which 
means you must code the bin parameter in the form of a 
string* for example* bin-'ZZa*. The string delimiters &££ 
required if you don't want SES complaining about invalid 
numbers* If you don't code a bin parameter* PRINT uses the 
value of profile variable userbin* and if there's no such 
profile variable defined* generates a listing banner of 
NO-ID* which almost certainly guarantees that your output 
goes to the N0S/WQ SIN NUMBER bin. The bin parameter Is 
aa£ aatailakle. at Arden Hi lis* 



setid is another Sunnyvale special* If your printout is 
destined for the "normal" ( pr intercede) Jiisalas £ad£ 
printer* QQ.t the ASCII printer* iqjJ 1£ your printout Is 
large (more than about 100 pages)* please be nice to 
operations and code setid*6 or Just plain setid 6* Printer 
id 6 is for long print runs* so be good to the world at 
large (including yourself) and use printer 6 for long 



printouts. 



compres : 

(optional) keyword specifies multiple copies are printed 

together on one listing with only one NOS banner* When 

compres is used the number of heading banners is defaulted 

to zero unless overridden by specification of values for tin 
or shn. 



cs612 or cs64 or cs812 : 

these (optional) &£¥£ can be used to specify the character 
set of the file(s) to be printed. If you don't code any 

COMPANY PRIVATE 



2-4 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User's Handbook REVs AB 

2*0 PRINTING FILES 

of these keys or if you code the cs612 ksy.* the file(s) is 
(are) assumed to be in the NGS 6/12 ASCII character set. 
If you code the cs64 fce.2* the flle(s) is (are) assumed to 
be in the 64 character ASCII subset or display code 
character set. If you code the cs812 &&%» the file(s) is 
(are) assumed to be in the "8 out of 12 w ASCII character 
set. 



shift or noshift or cups s 

these (optional) &£*£ control whether the printout is 
SHIFTed before disposal to the printer* If you don»t code 
any of these &£¥£» PRINT examines each file to determine 
ho* to prepare it for printing (i.e. which of these fcejfs 
should have been selected). Hats 5 that this automatic 
determination works for the vast majority of files and 
that this parameter is provided for use only in those rare 
cases where the automatic method fails* Note also* that 
the option you select with this parameter applies to all 
files to be printed, and therefore in the automatic case a 
mix of "shifted" and "unshifted" files can be printed with 
one procedure call. If you code the shift fcay.* PRINT 
shifts (i.e. adds "carriage control" characters at the 
left of each line) each file In order to "format" the 
fiie(s) for printing. If you code the noshift lisy.* PRINT 
assumes each file is already "formatted" for printing and 
therefore does no shifting. The caps fcgy. is a special 
form of noshift* where any line that contains aQi¥ a 1 In 
column one is deleted* and any line starting with an 
asterisk (*) in column one is also deleted* This is 
intended for printing the output of programs such as 
COMPASS and CATALOG which try to print on "prime pages". 
This idea is out of date these days* and the cmps lis* 
helps save paper. 



date or etad : 

this (optional) &e.y. specifies the form in which the DATE 
Is to be output on the banner. If you code the date &££• 
PRINT uses the form 01 AUG* 78* which is the default. If 
you code the etad fcsy.* you get the standard system date 
format. 



time or ampm s 

this (optional) Jssv. specifies the form in which you get 

the TIME on the banner* If you code the ampm fcfiy.* PRINT 

uses the form 4*23 PM* which Is the default. If you code 
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2,0 PRINTING FILES 

2*1 PRINT - PRINT FILECS) 



the time &e.*# you get the standard system time format. 



Examples of PRINT Usage 



ses. print (myfile* hisfile* herfile) 

* END PRINT HYFILE.. HERFILE 



This example prints three files J myflle* hisfile and herfile on 
the ASCII printer* The example shows the message that appears at 
the end of the print process* 



ses. print formout* c*3« noshlft 
* END PRINT FORMOUT 

This example prints three copies of the file formout without 
shifting the file (the noshift fc.e.i>* 
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2.0 PRINTING FILES 

2.1 PRINT - PRINT FILE(S) 



If you wish* you may establish default options for PRINT by 
setting variables in your PROFILE. The profile variables that print 
uses are defined here. 

copies default number of copies to print* 

hn default number of heading banners to print at the start of 
a printout* 



shn default number of subheading banners to print at the start 
of every file in a multi file printout. 

printer default printer to be used. Refer to the fitiHtSC ©arameter 
in the procedure description above. 

incset default character set of filets) to be printed. Refer to 
the &&&12 parameter described above. 

shift sets your default for shifting files or not. Refer to the 
Sbift &£! description above. 

userbin used only at Sunnyvale Development Division, userbin sets 
up your default bin number. 

In addition to the profile variables described above* there are 
profile variables that PRINTID uses. See the description of these 
at the end of the PRINTID procedure description. 

tlfltfi : because the userbin profile variable is used by PRINT* it 
is also used indirectly by any SES procedure that uses PRINT. 
userbin is also used by those SES procedures that can run in batch. 
If you run procedures in batch* userbin is used to place bin number 
banners on the batch job output. 
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2«2 PRIJJTIO - PRINTJ|LAR6E PRINT^HEA^ 

PRINTID is mainly used as a building block for other procedures* 
It produces a "large print" heading banner* that occupies a full 
page* using a program called JOBID which is described in an appendix 
to this document* Parameters to PRINTID are s 



h or Id * 

this parameter way be any arbitrary character string which 

specifies the text to be output* The string used can be 

anything that's legal for the JOBID program* 

copies or c or n or hn or idn s 

(optional) Number of CQPXES of the banner that you want 
output* If you don't code the copies parameter* PRINTID 
produces two (2) copies* 

o or output s 

(optional! name of file to which the banner is to be 
Output* If you don't code the o parameter* PRINTID uses 
fi le OUTPUT. 



date or etad : 

this (optional) j££x specifies the form in which the DATE 
is to be output on the banner. If you code the date fc£X» 
PRINTID uses the form 01 AUG, 78t which is the default* 
If you code the etad fcey.* you get the standard system date 
format* 



time or ampm : 

this (optional) &£* specifies the form in which you get 
the TIHE on the banner* If you code the ampm &£** PRINTID 
uses the form 4* 23 PH# which is the default* If you code 
the time Js£i» you get the standard system time format* 

cs612 or cs64 or cs812 i 

these (optional) &£xi specify the character set in which 
PRINTID output is to appear* If you don't code any of 
these &£is or if you code the cs64 fc£j> output is in the 
64 character ASCII subset (can also be thought of as 
display code) character set* If you code the cs612 &£,** 
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2.2 PRINTID - PRINT "LARGE PRINT" HEADING BANNERS 



output is in the NQS 6/12 ASCII character set tsince 
PRINTID output does not include any of the so-called 
extended characters* cs612 is effectively equivalent to 
cs64 for this procedure)* If you code the cs812 &£,*• 
output is in the M 8 out of 12" ASCII character set* 
&atS-: that when PRINTID is called by the PRINT 
procedure* that this parameter is set according to the 
destination printer; the PRINT procedure has a parameter 
with these keys and it refers to the character set of the 
f i I e(s) to be pr inted* 

Note that the date and tiifi parameters only have effect when the 
& parameter is specified as a name* If you give the tl parameter as 
something other than a name* it is up to you to include the date and 
time in the heading if you want it* 



Example of PRINTID Usage 

ses.prlntid i d* • fi nal /debug/document 1 • o»banner 
* END PRINTID BANNER 

This example shows a title banner being formatted onto a file 
cal 1 ed banner. 
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You can establish defaults for various PRINTIO parameters by 
coding them In your PROFILE* The profile variables are described 
here* Also refer to the PRINT profile variables* 

myid is a character string specifying the default format for 

heading banners. For complete understanding of the 

following description refer to the documentation for the 
43810 program (which produces the banners) and to the SES 
Procedure Writer's Guide* 

The default heading banner format would be defined via this 
profile variable as follows 5 

\ my id »•»*/» •♦♦VALSf h)*+« *//)* •♦♦mydate*** *// 1 « •♦♦ray time* 

Other heading banner formats can be constructed in an 
analogous manner. To eliminate heading banners altogether 
(as the default case) you should code the following line in 
your prof i le s 

\ myid » NO 

Note that in order to produce a heading banner* the length 
of the string assigned to the myid variable must be at 
least 4 (four)* 



mydate is a character string containing your version of the date* 
Refer to the date isgy. in the procedure description above* 

mytime is a character string containing your version of the time* 
Refer to the tiift j$e.x in the procedure description above* 

outcset can be used to specify the default character set for 
PRIMTID output* Refer to the cs$& j££i in the procedure 
description above. Note that this variable has no effect 
when PRINTIO is being called by the PRINT procedure. 
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COPYSAF prepares a file for printing on the NOS ASCII printer* 
The file in question is converted to the ASCII8 character set if 
required* and shifted {carriage control added) if required* 
Parameters to COPYSAF are s 



i or f 



O 3 



naie of Input £ife to be prepared for the printer. 



(optional! name of file to receive the Qutput from 
COPYSAF* If you don't code the o parameter* the output 
appears on the file specified by the i parameter* 

incset or ic i 

(optional! designator for the INput file's Character SET* 
The table below describes the allowed designators* 

outcset or oc s 

(optional) designator for the OUTput file's Character 
SET* The table below describes the allowed designators* 

shift or noshift or cups * 

these (optional) jssxs control whether the printout is 
SHIFTed before conversion* If you don't code any of these 
l££X2* COPYSAF examines the file to determine how to 
prepare it for printing (that is* which of these fcftxs 
should have been selected!* JiQfcg 2 that this automatic 
determination works for the vast majority of files and 
that this parameter is provided for use only in those rare 
cases where the automatic method fails* If you code the 
shift Isfil* COPYSAF shifts (that is* adds "carriage 
control** characters at the left of each line) the file in 
order to "format** the file for printing. If you code the 
noshift is** COPYSAF assumes the file is already 
"f ormatted" for printing and therefore does no shifting* 
The cmps tlfil Is a special form of noshift* where any line 
that contains aQil a 1 *n column one is deleted* and any 
line starting with an asterisk (*) in column one is also 
deleted* This is intended for printing the output of 
programs such as COMPASS and CATALOG which try to print on 
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"prime pages". This idea is out of date these days* and 
the cups &££ helps save trees* 



The incset parameter has a default of cs612 (NQS 6-12 character 
set) and the outcset parameter defaults to cs812 (ASCII character 
set suitable for the NOS ASCII printer)* as described in the table 
below* but these defaults can be overridden by defining in your 
profile defaults via variables with names the same as the 
parameters* The following table defines the allowed designators for 
the incset and outcset parameters * 



♦— 



Qesifloatai: . Iteaaina S 


CS612 5 NOS 6/12 ASCII character set 2 

cs64 ' 64 character ASCII subset (display code) S 
I character set * 


cs812 ? M 8 out of 12" ASCII character set 5 
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Examples of COPYSAF Usage 

ses.copysaf listing* topress* noshift 

* END COPYSAF LISTING -> TOPRESS 

ses.copysaf outfile* cs64 

* END COPYSAF OUTFILE 

The first example of COPYSAF converts the file listing from the 
6-12 character set to the 8-12 character sett placing the result on 
file topress. The noshift js§y. ensures that the file is not shifted 
during the conversion. The second example is converting a display 
code file to the 8-12 character set ready for printing* and COPYSAF 
determines whether to add carriage control to the file* 



COMPANY PRIVATE 



2-13 

COC - SOFTWARE ENGINEERING SERVICES 

7/30/81 

2.0 PRINTING FILES 

2 • 4 ft4tW£&-=.H&II£.aili-liUtlft£8-QIi.LA8LfiE-£&IliI-fiAIHi£&-£ Afi£ 

This procedure is a special form of the PRINTID procedure for use 
in Sunnyvale to identify printed output* 

BANNER is intended for writing the user's bin nuiber on a large 
print banner page Cactuaily it produces two pages of banner) on 
printouts or in the dayfile of a batch job. BANNER produces two 
pages with your bin number arranged in a geometrical pattern that 
makes It easy for the process control persons to see. BANNER 
outputs the page in different patterns depending on the number of 
characters in your bin number. Parameters to the BANNER procedure 
are 5 



bin 



is your (ootional) bin number. This must be specified In 
the form of a string* for example* bin» , 018d». If you 
don f t code the bin parameter* BANNER uses the value of 
profile variable userbin* and if there's no such profile 
variable defined* generates a bin number of NO-ID which 
almost certainly guarantees that your printout ends up In 
the NQS WITHOUT BIN NUMBER bin. 



o or output : 

is the {optional) name of the file on which the banner is 
to be written. If you don't code the o parameter* the 
banner appears on file output by default* making this a 
convenient default for batch jobs. 



Examples of BANNER Usage 



ses. banner 

* END BANNER 



ses. banner bin« f 13b f * o*tempout 
* END BANNER TEHPOUT 



The first example shows the simplest use of BANNER with the 
banner going to file output* and the bin number either obtained from 
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the userbin variable in the profile* or the default NQ-ID 
generated* The second example shows how to code the bin number 
parameter on the procedure line* 



The only PROFILE variable used by BANNER is : 

userbin defines your output M bin w identifier as a character 
str ing* 

Siflifi s that the userbin profile variable is also used by PRINT* 
and thus indirectly by any SES procedure that uses PRINT* userbin 
is also used by those SES procedures that can run in batch* If you 
run procedures in batch* userbin is used to place bin number banners 
on the batch job output* 
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3,0 DOCUMENT FORMATTING SYSTEM 



3.0 £Q£UM8I-£13£BAIII!i£-Sm£a 



The documentation formatting system is a powerful set of programs 
that can produce documents from unformatted source text* containing 
directives to control margin alignment? itemising* tables and so 
on* There are facilities to compare two versions of a document to 
generate revision bars to indicate changes* and facilities to change 
heading formats and so on* 

The major components of the documentation system are two 
processors called TXTCOOE and TXTFORM* TXTCOOE is in fact a high 
level preprocessor for TXTFORM* See the "Applicable Documents" 
section of this document for the manuals that describe TXTCOOE and 

TXTFORM, 



After the main descriptions of FORMAT and FORMREV* there are a 
number of "data flow diagrams" showing the processes that are run by 
coding different parameter combinations on a FORMAT or a FORMREV 
procedure usage. 

FORMAT runs the complete document formatting system in all its 

manifestations and options* while the rest of the 

procedures described after FORMAT are the individual 
components of the system* 

FORMREV runs the document formatting system to generate a revision 
package* complete with change pages and change directive 
summary* 

SPELL produces a list of suspected misspelled words from a text 
file* 

TWOPAGE places two formatted document pages on one printer page* 

DIAGRAM aids the construction of block diagrams such as those found 
later in this section. 
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MEMO produces a standard format memo* 

TXTCODE runs the high level preprocessor for TXTFORM* 

TXTFORM produces a formatted document* 

TXTHEAO a TXTFORH post processor which changes heading banners on 
document pages* 

GENREVB works in conjunction with TXTFORM to format a document with 
revision bars down the right side of the page to show 
changes from a previous document* 

GENREVP builds a revision package by comparing the output of two 
formatted documents. 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



3 . 1 £Q£t!4I.=-ay!i-.aQCyil£tiI-£a£t3AIIIliS-SXSI£E 

FORMAT produces a formatted document either from TXTCODE source 
(the default)* or from TXTFORM source. FORMAT normally runs In 
batch rather than interactively* but you can run FORMAT at the 
terminal if you *ish* by coding the local lis* *#hen you run it. It 
is usually better to run the document formatters in batch since they 
consume some time. Parameters to FORMAT are * 

i or f J 

name of Input File containing source data to be formatted 
by TXTFORM or TXTCODE. 

b or old * 

(optional) name of file containing a Base or OLD version 
of the document source. If you code the b parameter* 
FORMAT compares the files specified by b and i such that 
revision bars are printed on the formatted output 
document. 

I or listing 5 

(optional) name of file to receive the output of the 
formatter in a form suitable for printing on the ASCII 
printer. If you don't code the I parameter* and you»re 
running FORMAT LOCAL at your terminal* the output appears 
on a file called listing. 

d or display s 

(optional) name of file to receive the output of FORMAT in 
a form suitable for DISPLAYing at a terminal* that is* the 
formatted document is truncated for a terminal screen. If 
you don , t code the d parameter* FORMAT doesn't produce any 
display file (unless you code the k parameter described 
below). 



batch job parameters * 

These parameters are described in section 1.7 - **SES 
PROCEDURES RUN AS BATCH JOBS*. The default for this 
procedure is to run in batchn mode* but it can be run in 
local mode. The dayflle parameter is used by this 
procedure. 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



print 



{optional) controls the action of the PRINT procedure* 
used to print the output of FORMAT* If you run FORMAT as 
a batch job (the default case) and you don f t code the 
print parameter* FORMAT prints one (1) copy of the 
document on the ASCII printer* If you run FORMAT In local 
mode or "while you wait*** FORMAT does not print any copies 
of the document* For a complete description of the values 
that may be coded for the print parameter » see the 
description of procedure PRINT* 



s or source * 

this (optional) &£¥ specifies that the SOURCE of the 
document is to be printed in addition to the formatted 
output* If you don't code the s &£*• the source isn't 
pr inted* 

k or keepout : 

(optional) name of file in which to KEEP the QUTput of 
FORMAT* You can use this facility where you may want to 
run many copies of a document at a later date* If there's 
no file of name specified by the k parameter in your 
catalog* FORMAT places the output in a DIRECT access file 
of the specified name* If such a file already exists* 
FORMAT overwrites it with the output of the run* 

Nfltfi * that If you code the k parameter* FORMAT produces a 
display file (see above) and saves that* rather than saving 
the full size listing file which is usually large* 



code or form or txtcode or txtform : 

these (optional) &2.Z5. determine which formatter is to be 
used by FORMAT to process the document source* If you 
don f t code any of these J££X£* FORMAT runs the TXTCODE 
process* which Is the same as if you coded the code or 
txtcode Js£y.S* If you code the form or txtform kfiy.* FORMAT 
runs the TXTFORM process* Hotel you can change the 
default selection by defining in your profile a variable 
called FORMAT and setting its value to 'TXTFORM* or 
♦FORM** 



head or txthead : 

this (optional) Isey. invokes TXTHEAD* a special 
postprocessor for the document formatting system* TXTHEAD 
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is used to change the headings that appear at the top of 
the document pages* where the standard headings are 
inappropriate. Documentat i on for TXTHEAO can be found in 
an appendix to this User Handbook. If you code the head 
&£¥* FORMAT runs TXTHEAO. 

twopage : 

this (optional) parameter* if coded* directs FORMAT to run 
the TWOPAGE procedure (described in this chapter) which 
places two pages on one printer page. Since the maximum 
width of a printer page is 136 columns* if you happen to 
have wide platen documents* the output tends to look rather 
strange* so for effective use of twopage* your documents 
should be less than 68 columns wide* twopage may be coded 
just as a Isfii* or it may have a list of values* namely the 
pw parameter and the seq &£¥* as in the description of the 
TWOPAGE procedure later in this chapter. 

tifttfi 5 that the twopage option fidy. affects the ELlQifid 
copy of the output. The actual data in the files specified 
by the d or I parameters is not affected. 



nsg or nomsg : 

these (optional) 11SY.S. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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3.0 DOCUMENT FORMATTING SYSTEM 

3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



Examples of FORMAT Usage 



ses.format myf 1 le 

17.42.55. SUBMIT COMPLETE. 
* JOB FORMAT SUBMITTED 



J08NAME IS ADCQBUG 



using FORMAT. myfile 
The document is 



This is the very simplest example of 

contains document source written in TXTCODE form, 

processed by FORMAT* and one (1) copy is printed on the ASCII 

printer. FORMAT runs as a batch job* freeing up your terminal for 
further processing. 



ses. format newfile* oldfile* 

13.32.55. SUBMIT COMPLETE. 
* JOB FORMAT SUBMITTED 



pr int*(c*2#h«no1# s* Jobt 1*4000(8 ) 
JOBNAME IS ADUOBOG 



This example is more complex. The files newfile and oldfile 
contain respectively the latest and previous versions of a 
document. Both versions are coded in TXTCODE form. FORMAT 
processes both lots of source* uses the revision bar generator to 
generate change bars on the final document. The source of newfile 
is printed because the s js.e.y. is coded on the call line. It's 
assumed that the documents are large and require lots of computer 
time to process them* so jobt I »4000 ( 8 ) is coded to give FORMAT twice 
the normal time. Finally* the print parameter specifies that two 
(2) copies are to be printed with f\o heading banners. 

ses. format i*newfile* b*otdfite* txtform* print*c«4 

11.35.43. SUBMIT COMPLETE. JOBNAME IS AORICAD 
* JOB FORMAT SUBMITTED 

This example shows FORMAT used to format the document newfile* 
with oldfile as the base version for generating revision bars. The 
txtform j$£v/ indicates that the source of the two documents is in 
TXTFORM format* and so the TXTCODE stage of FORMAT is bypassed. 
Finally* four (41 copies of the output are printed* because of the 
print»c»4 parameter. This last parameter indicates how the print 
parameter is coded when it has only one subparameter in its list* as 
opposed to the example above* where the print parameter has two 
subpar ameters In its list* so that they must be enclosed in 
parentheses. 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



ses.forrcat i»grabage local print d*looksee 

* RUNNING TXTCOOE ON SRABAGE 

* RUNNING TXTFORN 

* FORMATTED DOCUMENT ON FILE LISTING 

* PRINTING LISTING 

* CREATING DISPLAYA8LE OOCUHENT LOOKSEE 

* END FORMAT GRA8AGE -> LISTING LOOKSEE 

This example shows how to use FORMAT at the terminal* or "while 
you wait". The file grabage is assumed to contain the source of a 
document In TXTCOOE form* FORMAT runs while you wait because the 
local f£££ is coded* FORMAT places the formatted document on a file 
called listing and prints one CI) copy of it on the ASCII printer 
(because the print &£* was specified)* The file called looksee 
contains a copy of the formatted document suitable for displaying at 
a teminal* The example shows the informative messages output by 
FORMAT to reassure you that there»s something going on* 

ses. format draft batch twopage»seq 

12*10.30. SUBMIT COMPLETE. JOBNAME IS AMTBSOB 
* JOB FORMAT SUBMITTED 

This example shows the twopage option used to double up on the 
printed output and save a few trees* 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



&aU-£JLa*-.a£..£Q£!$M-ELa££iiji£££ 



ses.format l*anyfile 



ses.format l*anyflle» txtform 







Coding the 


/ I i\ 
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the input 
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for TXTFORM 
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PRINTER 



<— 



PRINT 



♦— 



The diagram shows two of the ways that FORMAT can run* depending 
on the options you code* The left hand diagram shows the normal and 
simplest case of FORMAT. The right hand diagram shows that coding 
the txtform or form Jse* el iminates the TXTCODE process* 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



ses.format i*newfile» b«oldfile 



this processes " 
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FORMATTER */ 
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4 —4. 



/ 



PRINT 



> TO PRINTER 



This diagram shows the action taken when you run FORMAT with a 
current document and a "base" version of the document. The revision 
bar generator compares the two files a£t££ TXTCODE has processed 
them* and generates the commands such that TXTFORM knows where to 
place revision bars in the final document* 
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3.1 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 



ses. format nyfife source 



* 

DOCUMENT I ♦ 
FORMATTER \i 

t 
+- + 4. 

/ s. /: 

TXTFORM I I 
DOCUMENT ! ♦ 
FORMATTER U 

" -♦— — ♦ 




TO 
PRINTER 




_• > tq PRINTER 



This diagram shows what happens when you run FORMAT and code the 
source &£*• The source of the document is printed directly* then 
the formatting process takes place to produce a formatted document. 
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FORMREV is Intended to format documents and run the GENREVP 
package described later* to produce a revision package for a 
document. FORMREV uses the FORMAT and GENREVP procedures in a 
manner suitable for most of the standard day to day document 
applications* If you have any complicated situations you should use 
FORMAT and GENREVP "manual ly*» to cater for the situation you want. 
Parameters to FORMREV are s 

i or f or new s 

name of NEW Input File containing the new document source 
to be processed by FORMREV. 

b or old : 

(optional) name of file containing OLD document source to 
be processed by FORMREV. If you don*t code this b 
parameter* you should supply the file specified by the r 
parameter. 

r or rlist : 

(optional) name of file containing the output of a 
previous FORMAT run. If you don't code the r parameter* 
you should supply the file specified by the b parameter. 
Of course* both b and r may be coded. 

I or listing : 

(optional) name of file to receive the listing of the 
selected pages after the comparison. If you don't code 
the I parameter* FORMREV uses file listing. 



s or summary : 

(optional) name of file to receive the summary of the 
changes* and a "how to update the document** description. 
If you don f t code the s parameter* FORMREV uses file 
summary. 

o or output 2 

(optional) name of file to receive the OUTPUT of FORMREV. 
The output file contains error messages and statistics. 
If you don't code the o parameter* FORMREV attempts to use 

COMPANY PRIVATE 



3-12 
COC - SOFTWARE ENGINEERING SERVICES 

7/30/81 

3.0 DOCUMENT FORMATTING SYSTEM 

2zS«r£2525£H l„£2£52 T .,£ revision package^from oocument^source^^^^ 

PROFILE variable output* and if such a variable doesn f t 
exist* file output is used. 

batch job parameters : 

These parameters are described in section 1*7 - **SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batchn mode* but it can be run in 
local mode. The dayfile parameter is used by this 
procedure. 



print 



(optional) parameter list (as for the PRINT procedure) 
which controls the PRINTing of the I* s and o files. If 
you run this procedure in local mode* no printing is 
performed* If you run this as a batch job* the default 
action is to print one (1) copy of those files. 



format or formatl : 

(optional) list of parameters to control the FORMAT run 

that produces the new version of the text* The parameters 

are as for the FORMAT procedure described previously* 

format2 : 

(optional) list of parameters that control the FORMAT run 
that produces the old version of the text* in the case 
that the r parameter wasn't coded. The parameters are as 
for the FORMAT procedure described previously. 



genrevp : 

(optional) list of parameters that control the actions of 
the GENREVP procedure described below* when GENREVP is 
called into play during the run of FORMREV to produce the 
final output listings* The parameters are as for GENREVP 
described below. 



msg or nomsg : 

these (optional) fcfiv.s. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Examples of FORMREV Usage 

ses.formrev i*newdoc* b*olddoc 
09.45.34. SUBMIT COMPLETE. JOBNAME IS AEXICQG 

* JOB FORMREV SUBMITTED 

This example shows FORMREV used to generate a revision package by 
comparing newdoc (the current version) with olddoc (the previous 
version). FORMREV produces a printout consisting of those pages 
which differ between the two documents* and a summary indicating 
which pages are changed. The changed pages have revision bars 
against those lines that differ. 

ses.fonrev newdoc* r*oldlist» f ormat*txtf orm* jobt 1*5000(8) 
14.45.56. SUBMIT COMPLETE. JOBNAME IS JACIBHI 

* JOB FORMREV SUBMITTED 

This example generates a revision package by comparing the 
results of formatting the current document newdoc with the old 
listing file oldllst. The formatting process is to be done with the 
TXTFORM formatter* bypassing the TXTCGDE process* as indicated by 
the f ormat*tx tf orm parameter* The job time limit Is set to 5000 
seconds (octal) by the jobt 1*5000(8) parameter. 

ses.formrev l*current* b»dated* genrevp* ( how*comf 1 le* folio) 
16.32.48. SUBMIT COMPLETE. JOBNAME IS AFTXBUD 

* JOB FORMREV SUBMITTED 

This example shows FORMREV used to generate a change package for 
the documents current and dated. The portions of the listing pages 
that are to be ignored are not the standard ones normally used by 
the GENREVP procedure* so the genrevp parameter is coded to indicate 
that the directives are on file comfile* and that the folio line 
(indicated by the folio &£Y.) is also to be ignored for the purpose 
of comparison. 
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Qjta-flaa«al-EQS!iE£Y-Ei:a£S.ii4i£SS 



ses.f orwrev i*newfile* b*otdfile 
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The diagram shows how 
FORMREV processes a 
current version of a 
documents and an old 
version of the sane 
document* to generate 
a change package with 
revision bars on the 
changed pages* 
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ses.formrev i*newfile* b*oldfile* r*oldlist 
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This diagram shows FORMREV used to generate a revision package 
where ail three forms of the document are used 5 the current 
version of the document* newfile* the old version of the document 
source* oldfile* and the old document listing* oldlist. In this 
case* FORMREV uses the old listing as the base against which to 
compare the processed version of the new document* Because the old 



document source was used as well* 
FORMREV have revision bars on them* 



the change pages produced by 
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ses.f ormrev i»newfite» r*oldlist 
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This diagram shows the simplest use of FORMREV. The current 
version of the document is compared with the old listing of the 
document in order to generate a change package. In this case there 
are no revision bars generated on the final output since there was 
no old document source given to FORMREV to be processed. 
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3.3 £E£LL™£li££i£-£ILE-£Q&-$£EUI£l£-!3im&££ 

SPELL checks for words in a document that are spelled 
Incorrectly. Parameters to SPELL are J 



I or f s 



name of Input File to be checked for spelling mistakes. 



(optional) name of the file to receive the Output from 
SPELL* If you don*t code the o parameter* SPELL uses file 
OUTPUT. 



diet or d s 

(optional) name of a file containing words tone per line* 
left justified* all letters in lower case) that are to be 
used in conjunction with standard "difiii onar y w used by 
SPELL* If you don't code this parameter* SPELL uses only 
the standard dictionary (containing approximately 50000 
words) when checking for misspelled words* 



di ctun or dun : 

(optional) Username in whose catalog the additional 
dictionary specified by diet is found* The default Is the 
current user's catalog* 



lo 



(optional) List options available for output format* 
brief* the default* displays three columns containing each 
"mlspelled" word* the Input file line number at which the 
word was first encountered* and the number of subsequent 
references of that word in the text. 

full is a proof reader's format. The entire text fine 
containing the "misspelled" word is printed out and the 
word in question Is "flagged" on every occurrence. 
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Examples of SPELL Usage 

ses.spel I neifdoc 

* END SPELL NEWDQC 

This example shows the simplest use of SPELL* A list of the 
words in file NEVTDOC that are suspected to be misspelled along with 
a count of the number of times each occurs is written to file 
OUTPUT* Only the standard dictionary was used since the diet 
parameter was omitted* 

ses.spell i*somedoc* di ct» jar gon# o»baddies 

* END SPELL SOMEDOC 

This example shows SPELL applied to a file called SOMEDOC with 
additional words from dictionary file JARGON. The output of SPELL 
appears on file BADDIES* 
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2:^I!f2Si5Si*r*S5I!3I^IH2-,22£yi!!i!!i T w £i G,ES * s ££ E 9Y SIDE 

3 . A IMQ£AfiE.=.£RIliI-IMfl.QQ£UH£iai-£ AfiES^iaE.ai-ilQ£ 

TWOPAGE takes the output of any of the text processors and places 
two output pages on one printer page* This reduces both paper usage 
aasJ print time* which is invaluable while documents are in their 
development stages and being turned around fast* 

The input for TWOPAGE must be in 8 of 12 ASCII format and ast in 
NQS 6/12 ASCII* Its output is also in 8 of 12 ASCII. Parameters to 
TWOPAGE are : 



I or f 



name of Input £ i I e to be processed by TWOPAGE. 



(optional) name of Qutput file from TWOPAGE. If you don*t 
code the o parameter* the output appears on a file of the 
same name as the input file specified by the I parameter. 

pw or width * 

(optional) £age Itidth of the output pages. If you don't 
code the pw parameter. TWOPAGE uses a default page width of 
137 (136 columns plus one column of carriage control). 
Remember to cater for the carriage control column when 
specifying the page width. 



seq 



this (optional) fcfiy. indicates that SEQuence numbers are to 
be placed on the final printout. The sequence numbers 
appear down the center of the printer page between the two 
document pages. Default action in the absence of the seq 
lifiy. is no sequence numbers. 
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Examples of TWQPAGE Usage 

ses.twopage i*textoutf o«listing# seq 
* END TWGPAGE TEXTOUT -> LISTING 



ses«tt#opage formatd 

* END TWOPAGE FQRMATD 



CONPANY PRIVATE 



CDC -SOFTWARE ENGINEERING SERVICES 
SES CRelease 17) User f s Handbook 



3-21 

7/30/81 
REV? A8 



3.0 DOCUMENT FORMATTING SYSTEM 
3.5 DIAGRAM - DIAGRAM DRAWING AID 



3 . 5 auaaAB-=-aiM&Aa_a&4i£iM£.UQ 



DIAGRAM is a documentation aid for drawing diagrams* The "data 
flow diagrams* 1 in this section of the SES User f s Handbook were drawn 
using DIAGRAM* Basically* a page is considered as a three column* 
five row grid* into which you can place various shapes* You still 
have to do some manual editing to join lines and add text* but the 
bulk of the pain of drawing the shapes is done for you* Shapes 
available via DIAGRAM are those shown below* with their "names" 
given for reference* 



"BLANK" 



xxxxxxxxxxxxx 1 
xxxxxxxxxxxxx * 
xxxxxxxxxxxxx * 





• 
• 


"CONN* 




• 




/ 




\ 


1 


X 


1 
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• 
• 

• 
• 


/ 




• 
• 


"OUT" 




• 
• 






« 
• 
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f \ 


1 




V 


1 




\ 



IN" 



I "CQND" 

/ \ 
♦ / \ * 

xxxxxxxxxxxxx I 
xxxxxxxxxxxxx 1 
xxxxxxxxxxxxx 5 

\ ? / ♦ 

\ / 



"LINE" 



\ / 



5 "STACK" 

+ + + 

• » 

• :-♦ 

♦-♦ ♦ * 

X xxxxxxxxx ?-♦ 



"TABLE" 
— 4. _+ 

TABLE 



xxxxxxxxxxxxx 
xxxxxxxxxxxxx 
xxxxxxxxxxxxx 

« 
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— ♦ 



I xxxxxxxxx 
* xxxxxxxxx 

J xxxxxxxxx 

♦*. —I— — -♦ 



To use DIAGRAM you call up the SES DIAGRAM procedure with the 
following parameters * 



name of the file to receive the Qutput from DIAGRAM. This 
parameter is required* 

The next three parameters are introduced by the keywords cl and 
c2 and c3. They represent a list of shapes that are to be placed In 
column one* column two and column three of the page grid* 
respectively. For example* the grid of shapes given above was 
generated by the following SES call : 



ses.di agram o»anyfile. cl« ( bl ank> conn* out* cube) > 
c2*(box* in»stack)» c3« < cond» li ne» t ab I e) 



where anyflle is the output file used for the example, 
"names'* were added by editing the output file. It is 
include diagrams in your file in "asis* mode. 



The shape 
usual to 
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3 * 6 HEttQ_z-££li£&AI£-SIAliBA&a-ttEttQ-tiEAQ£& 

MEMO places a standard TXTCODE format banner at the front of a 
file containing the text of a memo* Date* 'to 1 * »from f and subject 
information can be entered as parameters to MEMO* Internal to the 
resultant file* the TXTCODE table directives are set up such that 
further recipients 1 names way be added easily* Parameters to MEMO 
are as f ol lows s 

i or f 2 

name of Input £ile containing the text of your memo* to 
which the standard header is to be added. 



o : 



tO 3 



(optional) name of the file to receive the Output of MEMO. 
If you don*t code the o parameter* MEMO places the output 
on the file specified by the i parameter* 



(optional) name and location of the person to whom the memo 
is to go* It is coded as a list? the first item in the 
list is the recipients name and the second item is the 
I ocat i on* 



from s 

(optional) name and location of the person sending the 
memo* It is coded similar to the to parameter. 

nhen : 

(optional) date to be placed on the memo* If you don't 
code the when parameter* MEMO uses today f s date as a 
def au It. 



s or subject s 

(optional) string which is the subject line to be placed in 
the memo* 

Some of the parameters above can get default information from 
your profile* as follows 3 
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faccode is the £A£ifity £QD£ variable. The value of faccode are 
used both for the to and from location if they aren't 
specified as parameters. 

Byname is the profile variable containing your name* which is also 
used by the mail facilities. If you don't code the first 
element of the from parameter list* MEMO uses the myname 
profile variable. 

By this time you should be suitably confused by this explanation 
so an example Is in order * 

ses.memo i«anyfife» to*(*Ethel Snerge't I ondon)* • ••• • 
from*! "Stanislaus Bonokowonokowl tch» * paris)*..... 
subject^'hunt ing the snark* 

* END MEMO ANYFIIE 



The result of this would be a standard memo header at the start 
of anyfile as shown on the next page 5 
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\para 

\setu~ 

\seth A 

\setb9 

Xblank 

Xskip4 

Xasis 

\bold 



010 



MM MM 
M M M M 
M M M 
M M 
M M 



EEEEEEE 

E 

EEEEE 

E 

EEEEEEE 



MM MM 
M M M M 
M M M 



d 



00000 




00000 



\nobol 
\table 
Xskip4 

;***DATE** A MAR 14* 1979 
Xskipl 
XtableU*45 

.***** T0 * : * ETHEL $ N ERGE|LOCATION***tONDON 
Xtable|ll>56 
Vsklpl 
\table 

- AAA 



f F 
Xtabte 
XskipZ 
Xtabie 

;SUBJ 
Vblock 
\skip4 



51*45 

ROM A **STANI$tAUS BOMOKOMONOKOWITCHlLOCATION^^PARIS 

Ml* 56 

;l*45 

ECT A ***HUNTING THE SNARK~ 
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3 • 7 IiIdQQ£.-.ayii.IXICQQ£«aQaUi5£^I-EE££aQS:£i£Q£ 

TXTCQDE is a high level preprocessor for TXTFORM* This procedure 
runs TXTCODE in a stand alone fashion. It nay be used as a building 
block for larger procedures to form a complete document formatting 
system. Parameters to TXTCODE are s 



i or f s 



o : 



e i 



name of Input File containing source text to be orocessed 
by TXTCODE. 



(optional) name of file to receive the Output from 
TXTCODE. If you don't code the o parameter* the output 
appears on the file specified by the i parameter. 



(optional) name of file to receive the Error output from 
TXTCODE. If you don't code the e parameter* TXTCODE 
doesn't produce any error file. 



Example of TXTCQDE Usage 

ses.txtcode codein codeout err 1 1st 

♦ END TXTCODE CODEIN > CODEOUT* ERRLIST 

This example shows TXTCODE used to process the data contained In 
file codein* and produce the TXTFORM source on file codeout. Any 
errors go to file errllst* 
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3 . 8 imaftfl_-_aus-mEQ&a.aocua£i!i-e&a£ESSQ& 

TXTFQRM is the main component of the document processing system* 
This procedure runs TXTFQRM stand alone. It can be used as a 
building block for larger procedures to form a complete document 
formatting system. Parameters to TXTFQRM are s 



I or f * 



name of Input File containing source text to be processed 
by TXTFQRM. 



(optional) name of file to receive the Output from 
TXTFQRM. If you don't code the o parameter* the output 
appears on the file specified by the i parameter. 



Example of TXTFQRM Usage 



ses.txtform i*forminp> o*formout 

* END TXTFQRM FQRMINP -> FORMQUT 
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3 . 9 maEAa_ = _£AfiE-MEAQI!i£-£&aC£SSQ& 

TXTHEAD is a postprocessor for TXTFORM. TXTHEAO is used to 
change the format of the heading banners on document pages* where 
the standard heading format is inappropriate. There is 
documentation on TXTHEAD in and appendix to this User Handbook* 

This TXTHEAD procedure runs TXTHEAD in a stand alone fashion* It 
may be used as a building block for larger procedures or jobs to 
form a complete document formatting system* Parameters to TXTHEAD 
are s 



I or f i 



name of Input File containing TXTFORM output which is to 
be processed by TXTHEAD. 



(optional) name of file to receive the Output from 
TXTHEAD. If you don't code the o parameter* the output 
appears on the file specified by the i parameter. 



Example of TXTHEAD Usage 

ses.txthead i*fornout* o»headout 

* END TXTHEAD F0RN0UT -> HEADOUT 

This example shows TXTHEAD being used to process the output of 
TXTFORM contained on the file formout* and produce the output file 
headout. 
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3 . 10 ££m*ft.::-fi£tiEfiAI£-aEmiati-flWES-£aR-QQ£UfiElttS 

GENREV8 is a procedure that works in conjunction with TXTFORM* to 

format a document with bars down the right hand side of the page to 

show changes from a previous document* GENREV8 functions by 

comparing the source text of two documents and generating a set of 
special directives to TXTFORM. Parameters to GENREVB are s 



i or f or new 5 

name of File containing the NEW version of the document In 
TXTFORM source format. 



b or old : 

name of file containing the OLD Cor Base) version of the 
document in TXTFORM source format. 



o i 



(optional) name of file to receive the Output from 
GENREVB. If you don«t code the o parameter* the output 
appears on the file specified by the i parameter. 



newcset : 

(optional) designator for the NEW file»s Character SET. 
The table below describes the allowed designators. 



oldcset : 

(optional) designator for the OLD file f s Character SET. 
The table below describes the allowed designators. 



outcset : 

(optional) designator for the QUTput file»s Character 
SET. The table below describes the allowed designators. 



Is or ignorls : 

these (optional) Ee.y.5, specify whether or not to I£fciQ&e 
Leading Spaces on lines being compared. The default action 
is to recognise leading spaces (the is option). If you 
code the ignorls Efiy.* GENREVB ignores leading spaces on 
text I ines. 
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The default character set designator for all three cset 
parameters is £S&12* The following table defines the allowed 
designators for the cset parameters * 




Bsaaina 



cs812 



NQS 6/12 ASCII character set 



64 character ASCII subset (display code)'* 
character set * 



I M 8 out of 12 M ASCII character set 



Exaaple of GENREVB Usage 



ses.genrevb i*newtext* b*ofdtext» o*changes 

* END GENREVB NEWTEXT * OtDTEXT -> CHANGES 



This example shows GENREVB used to compare the two document 
source files newtext and oldtext* and produce the change directives 
in the text on file changes 
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GENREVP builds a revision package by comparing the output of two 
formatted documents. Parameters to GENREVP are s 



new or newdoc t 

name of NEW DOCument to be processed by GENREVP* 

old or olddoc s 

naie of OtO DOCument to be processed by GENREVP* 

how or howf I le : 

is (optional) and specifies HQW the processing is to be 
performed* that is* which lines are to be ignored for the 
purposes of the comparison (date* time and such)* The ho** 
parameter is fcil&fct the name of a file containing the 
directives* at it's a list of character strings on the 
control card which specify the directives* If you don't 
code the how parameter* GENREVP attempts to use the file 
name associated with PROFILE variable myhowf. If there 
isn't such a variable In your profile* GENREVP uses a 
standard set of directives suitable for the standard 
output of FORMAT* 

I or listing s 

(optional) name of file to receive the listing of the 
selected pages after the comparison* If you don't code 
the I parameter* GENREVP uses file listing* 

s or summary s 

(optional) name of file to receive the summary of the 
changes* and a "how to update the document" description* 
If you don't code the s parameter* GENREVP uses file 
summary* 

o or output * 

(optional) name of file to receive the OUTPUT of GENREVP* 
The output file contains error messages and statistics* 
If you don f t code the o parameter* GENREVP attempts to use 
PROFILE variable output* and if such a variable doesn't 
exist* file output is used* 



folio 



this (optional) Jsai indicates that the FOLIO line of the 
documents is not to be compared for the purposes of 
generating the revision package* 
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Directives to GENREVP (specified via the Hon parameter) are of 
the following form (one per line) J 

LI. .12 C1..C2 comments 

L1..L2 specifies a range of lines (if you only want to indicate a 
single line* the #.12 can be omitted? and if you want to indicate 
all lines* use an *)5 and C1..C2 specifies a range of columns (if 
you only want to indicate a single column* the »*C2 can be omitted; 
and If you want to indicate all columns* use an *)• Any comments 
present on a directive line are ignored. The directives are used to 
tell GENREVP what parts of what lines are to be ignored when 
comparing pages of formatted documents for differences. The 
standard set of directives is s 



2 


60. .79 


page number 


3. .4 


60. .79 


date 


* 


80. .136 


formatting codes (junk) 


60 


*. 


f ol i o 1 ine 



The last directive is generated only if the folio parameter is 
given. 



Examples of GENREVP Usage 

ses.genrevp thisdoc* thatdoc* folio 

* END GENREVP THISDOC*THATDOC — > LISTING*SUMMARY 

This example of GENREVP compares the two document listings 
thisdoc and thatdoc to generate a listing of the changed pages on 
the file listing* and a summary of the changes on the file summary. 
The folio bLgy. indicates that the folio line is also to be ignored. 
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ses.genrevp grab* hold* how-C^*.* 60»«79»# ** 80. .999*1 folio 
* £HQ GENREVP GRABtHOLD — > LISTING#SUMNARY 

This example sho*s the hon parameter of GENREVP used to indicate 
that character positions 60 through 79 on lines 3 through 4 are to 
be ignored for the purposes of comparison* and that character 
positions 80 through 999 on ail (*} lines are to be ignored* In 
addition* the folio &£i indicates that the folio line is also to be 
i qnored. 
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SES provides a comprehensive set of procedures to manage source 
text libraries* The source text maintenance package of SES is based 
on a special version of the NOS utility MODIFY called MADIFY. 
MADIFY differs from the standard version in that it caters for the 
NOS 6/12 character set? and it supports QgstglS and fisaiiitiaaai calls 
to common decks <see the description of the GENCQMP procedure for 
details on the CALL directives available to the MADIFY user). 

It's assumed that if you're using these source text maintenance 
procedures* that you're moderately familiar with the concepts of 
MODIFY* including things such as decks* common decks* correction 
idents and so on. If you're not* SES can't provide a substitute for 
knowing what you're doing. Before giving a short summary of the 
source text maintenance procedures* we'll introduce some of the 
terminology that SES uses. 



BASE 



is 



library of source text. All the source text 



maintenance procedures use a default name of 8ASE. 
establish a default base in your profile by coding 

\ base » f whatever_your_base_is f 



You can 



MODULE is a record of source text or\ a base. A module may be a 
COMMON module (COM or C or OPLO* or a module may be a 
REGULAR module (REG or R or QPL) 



GROUP is a file containing text in the form of MODIFY "source" 

records, i&at is*, gaaii iaai&ai cgaaifl* io tug £li& bas its 
Dams as tufi I1LS.JL iiflg a£ tag Lg&auU aad if tag cg&atd is. 
a Sanaa dgatu tag sgfi&ua' iiag g£ tag r.gs»£s: is tag Hand 
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GETMOD(S) GET MODuleS aut fl£ a base library aata a group file* The 
nodules appear on the group file in MODIFY "source" 
format as one module per logical record* 

REPMQDfSI REPIace or add MODuleS on a base library* You also use 
REPMODCS) in a special way to create a brand new base 
library from scratch* 

COLLECT collect a group of modules and accumulate them on a group 
f i le. 



GENCGMP GENerate a COMPile file for a 
modul es* 



modul e or a list of 



GENCGRfS) GENerate a CORrection Set for a module* 



TEMPCOR Make TEMPorary CORrections to a base without actually 
creating a new base* 

MODIFY MODIFY a base library with a correction set file creating 
a new base 1 1 br ary* 

CAT8ASE CATalogs a BASE library to produce a short list of the 
names and types of modules contained in a base library* 

LISTMOD LIST MODules. LISTMQD generates a cross reference 
listing of all the modules on a base (using the XREFMOD 
procedure described below)* and optionally a source 
listing of all the modules or all the common modules on 
the base* 

SORTMOD SORT a MQDify library* Modules appear on the sorted base 
in alphabetical order by deck name (the deck type is not 
used in the sort process)* 
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WIPEHOD WIPE (delete) MODules from a base, 

XREFMQD Produces a cross CXI REFerence of HOOules in a source 
library* For each module is listed the modules it calls 
(directly or indirectly) and the modules that call it 
(directly or indirectly). The LISTHQO procedure* 
described above* can be used to run XREFHOO as a batch 
job* 

GETCOMN ACQUIRES the CYBCCMN or CYBICNN common deck program 
libraries, in either the MADIFY or SCU forms* and makes 
them local to your control point* 
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REG 
(regular 

modules) 



issssiaassiitat 



/. 



COLLECT 



sssixtsstisttas 

COM 
— (common 
modules) 

9* *m* * mwtnm* mm m* 



— ♦ 



GROUP 
(accumulated 
modul es) 



CORS 
(correction 
sets) 



♦- — ~ — - ■ 
3 GETMOD(S) 
• (extract 
I modules) 



— ¥ 



t V 

\ REPMOD(S) \ 
• (replace • 



■.9999999: 

BASE 



/ 



♦ > 



/ V 

MODIFY 
(update 
base) 



/5 

— ♦ S 

* 



NEW BASE 



— ♦ 



StXSlSlfSSISlXI 

SF 
(source - — *• 
modules) 

assaiaatiaittsa 



+ — - 4. 4. 

/ V / 

4. —™— 4. 

GENCQMP 



-> 



CF 
(compl le 
fi le) 



COMPANY PRIVATE 



V-5 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES {Release 17) User*s Handbook REV? AS 



4.0 SOURCE TEXT MAINTENANCE 



This section introduces the parameter naming convention common to 
most of the procedures in the source text maintenance system* 

b or I name of Base Library on which the operations are to 

be performed* 

c or com or opfc list of naie(s) of COHmon module(s). 

r or reg or opl list of name(s) of REGutar moduletsl* 

m stands for Module(s)* and is used in those 

applications where the module names do not have to 
be explicitly specified as common or regular* 

g or group name of file upon which a GROUP of modules are 

accumulated when adding or replacing modules on a 
base* or when modules are extracted from a base* A 
group file contains one module per logical record* 
and may be edited using procedure MULTE0» and also 
may be processed by procedures PACK and UNPACK. 

cors or c name of CORection Set(s) to be applied against a 

base for maintaining correction histories* 

nb or nl name of a New Base or New Library* used in those 

procedures that perform operations that permanently 
alter a base* requiring that a new base be 
created* An explanation of the method used to 
update a base is contained in a subsequent 
secti on* 



COMPANY PRIVATE 



4-6 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES ^Release 171 UseMs Handbook REV? A8 



4.0 SOURCE TEXT MAINTENANCE 



£RQEXL£JfoLia&l££_£2£«&&UL££.Ifut£Ji£ia££Q£a££ 

The variables described below may be declared in your PROFILE In 
order to establish default information for the parameters of the 
source text maintenance procedures* 

base name of base library where modules are to be found or 
repl aced* 

baseown user name in whose catalog the base Is to be found* 

newbase name of new base library for those procedures which update 
a base library* thereby creating a new one* The default 
name for newbase is the same name as the old base* 

cors used by all procedures as name of file containing 
CORrection Sets to be applied to a base. The default name 
for this file is cors* 



group used by all procedures to designate a group file* or a file 
containing modules in source format* one module per logical 
record. The default name for group is group* 

cfseq used by GENCQMP to indicate whether to place sequence 
numbers on the compile file. If you wish to use this* 
declare it as seg* 

cfwldth used by GENCQMP to specify the width of the compile file. 
The default value for this is 110* 



sestmpb used by all of the procedures that update bases to specify 
the temporary base file during the update process* The 
default name for this file is sestmpb* 

lokmode used by all of the procedures that update bases* to 

determine the default interlock action* lokmode may be set 

to one of •LOCK* or •NOLOCK 1 . See also the sections below 
on updating bases and interlocking. 
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ifitrlok used fey ail of the procedures that update bases or 
libraries to specify the interlock file to be used during 
the update process. The default na?ae for this file is 
intr lok. 
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Some of the source text maintenance procedures physically alter a 
base* requiring that a new base be created* The process is common 
to all such procedures* and is as follows : 

If you code both the b and nb parameters* the newt base is created 
simply by performing the required operations on the old base* Af\4 
writing the newly created base onto the file specified by the nb 
parameter. 

If you code only the b parameter* the update takes place in two 
stages* The updating operation is performed and the new base 
written to a file called sestmpb (SES TeMPorary Base). sestmpb is 
then physically copied back over the file specified by the b 
parameter* and finally sestmpb is purged* 

Note that if the file specified by the nb <or b if nb is omitted* 
does not already exist* a OIRECT access READ mode file is DEFINEd 
for the base (this* of course* can only be done if the owner of the 
base is the current user)* 



Note that if anything goes wrong during an updating run* the 

original base is always left intact* and only the new base or 
sestmpb is potentially incorrect* This means that you can recover 

by purging the new base or sestmpb and starting the run again* If 

something goes wrong fc££pxe the base appears on sestmpb* the 

original base is intact* and sestmpb may be purged* whereas If 

something goes wrong a££st the new base is on sestmpb* that is* 

during the "rewrite" phase of the update* it is sestmpb that is 

safe* and the old base that Is wrong. In this case* you may use the 

REWRITE procedure to do the rewrite again* or alternatively* you may 

just purge the old base* then change the name of sestmpb to be the 
base name* 
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When updating a base or library you can interlock the update so 
that only one user at a time can update the base or library* Those 
procedures that update a base or library are set up so that if the 
base or library to be updated is in another user's catalog* the base 
or library is interlocked by default. You can override default 
actions by defining a lokaode variable in your profile* or by coding 
a lock or nolock &£¥. on the procedure* as shown in the diagram on 
the next page* 

Interlocking of a base or library is done via an interlock file* 
Such a file aus£ be a QlfcECI access file iq ifce. safflfi US££lS Gatalfifl 
3S £&£ fcass ar, iifctaxy. &£iOfl iiedaiSd* Naturally the interlock file 
must be a PUBLIC* WRITE MODE file if other users are likely to be 
using it* The default naie used by the SES source code maintenance 
and library management procedures for the lock file is Intrlok* You 
can have an interlock file of any naie by defining the intrlok 
profile variable* or by coding a file name as a value for the lock 
parameter on the appropriate procedures* 
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+_, 



4£ii22i Iak£Q 



lock 



library or base is locked 
lokmode profile variable o 



regardless of contents 
r other conditions* 



of 



nolock 



library or base is Qflt I oc 
of lokfflode profile variabl 



ked regardless of contents 
e or other conditions. 



fcUtfaina 



Caded ici Ecafiie * 



Aatiao IakfiQ 



lok»ode»«iOCK» 



* library or base is locked 

* unless overridden by nolock 

* parameter on procedure* 



V lok*ode*'NGLGCKM libra 

* unles 

* par am 



ry or base is Q2t locked 
s overridden by lock 
eter on procedure. 



♦-* 



^lliica 



+-< 



QanfiL Qf &ass 



Current User 



Another User 



ActifiQ IahLfiQ 



library or base is Dflt 
locked unless the lokmode 
profile variable is set 
to »L0CK« or the lock 
parameter is coded on the 
procedure. 



library or base is locked 
unless the loksode 
profile variable is set 
to 'NOLOCK 1 or the nolock 
parameter is coded on the 
procedure 
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* . 1 fiEIttflfi-Qa.fi£I!!QJiS-=-£ltIEA£I-llQfiULE-fiBflU£-£&Ql!-aAi£ 

GETMOD and GETMODS are synonyms for a procedure designed to 
extract a designated group of modules (or all modules) from a MAOIFY 
library* and place the extracted modules on a MADIFY "source" format 
file* that is* each extracted module occupies one logical record on 
the "source" file. Parameters to GETNQD(S) are s 



m or all s 

Coding the all fssx indicates that ALL modules are to be 
extracted from the specified base. The m parameter refers 
to a module or list of modules to be extracted. Ranges of 
modules may also be specified* 



g or group : 

(optional) name of file to receive the modules extracted 
from the base. If you don't code the g parameter* 
GETHOOCS) uses the value of profile variable group as the 
group file name* and if there's no such variable defined* 
GETHOOCS) uses the name group as the name of the group 
file. See the note on GROUP files at the beginning of 
this section. 



b or I 



un 



(optional) name of Base Library from which modules are to 
be extracted. If you don't code the b parameter* 
GETHOOCS) uses the value of profile variable base as the 
name of the base library* and if there's no such variable 
defined* GETMQDCS) uses the name base. 



(optional) User Name in whose catalog the base specified 
by b is to be found* if b is not in the catalog of the 
current user. If you don't code the un parameter* 
GETHOOCS) uses the value of profile variable baseown as 
the user name from whose catalog the base is to be 
obtained* and if there's no such variable defined* 
GETHOOCS) uses the current user's catalog. 



cors or c s 
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(optional) is a file containing a CORrectlon Set to be 
applied against the base b before the module m is 
extracted. If you code this parameter* SES procedure 
TEMPCOR is used to apply a TENPorary CORrectlon set* Note 
that TEMPCOR doesn't actually alter the base* the 
correction set is only applied for the duration of the 
GETMODCSJ run. 

w or width s 

Coptional) maximum Width of modules retrieved* 

status or sts * 

status is an (optional) parameter that can be used for 
those cases where GETMOD(S) is being used as a building 
block of more sophisticated procedures or jobs. The 
status parameter causes GETMQD(S) to set one of the job 
control registers to the value zero if GETMQD(S) 
successfully completed. and to non zero if anything went 
wrong during the run of GETMQD(S). The only values that 
may be coded for the status parameter are one of Rl* R2. 
R3 or EF» Any other value coded causes an error message 
to be output* and the GETMOD(S) procedure aborted. 



isg or nomsg : 

these (optional) fce.v.5. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Examples of GETHODCS) Usage 

ses.getmods (outllnd. I i mi tsd. • opr typk* ststypk* symen td. . symk ) 
* END GETMODS GROUP <- BASE 

This example shows GETMODS used to extract a bunch of modules from a 
base. Modules outlind* all modules limitsd through oprtypk. module 
ststypk* and all modules symentd through symk are extracted. Every 
parameter to GETMODS is set to its default value. The modules 
appear on the file group. 
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ses.getmods all b»cldbase un»dt73 g»junk 
* END GETM0D5 JUNK <- CIOBASE 

This example extracts ALL modules from base cidbase in the catalog 
of user dt73 onto a group file junk 

date ' A possible method of using this procedure is to extract a 

group of nodules using GETM0DS# to edit those modules using MULTED» 

and finally to replace the modules in the base library using 
REPMOD* For example s 

ses.getmods all b*cidbase; multed; repmods b*cidbase 

The example gets all modules from base cidbase* uses procedure 
MULTED to edit the group file <MULTE0»s default input file name is 
group)* then replaces all the modules on cidbase again* 
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4.1 GETMOD OR GETMODS - EXTRACT MODULE GROUP FROM BASE 



Qaia-£laH-a£_S£niQQI£l-uaafl2 



BASE 



:ssss*«asass 



+ — — + 

/ / 

>• GETMGDIS! 5~ 

! (extract S + 

J modules) 5/ 
♦ * + 



GROUP 
Mextracted 
modules! 



stsjssssasssts* 

CQRS 
(correction — 
sets! 

sstsssassitiias 



GETMODIS) is a fairly simple process * a list of modules is 
extracted front the base library* and appear on file group in MADIFY 
source form* that ls» one module per logical record. An optional 
correction set (the cors parameter) may be applied temporarily to 
the base before the modules are extracted. Procedure TEMPCOR 
applies the temporary correction sets. 
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4.2 REPMOD OR REPMODS - ADO OR REPLACE MODULES 



4, Z &£EaQ2_aS-S££flGa$.=-&Qa-QE-&£!>LA££ JiaaUL£S 



REPHQ9 and REPHOOS are synonyms for a procedure for adding or 
replacing module(s) on a base. Parameters to REPMQDIS) are « 



m 



(optional) list of Modules to be added to or replaced on 
the base. If you don't code the m parameter* REPMQDCS) 
assumes that the module(s) to be added or replaced are on 
the group file specified by the g parameter. Note that 
each file specified by the m parameter is treated as a 
MADIFY source file (or "group" file) with exactly aae. 
module on it* See the note on GROUP files at the 
beginning of this section. 



g or group s 

(optional) name of the group file to be used to accumulate 
the modules. If you don't code the g parameter* REPNOD(S) 
uses the value of profile variable group as the group file 
name* and if there's no such variable defined* REPMQDIS) 
uses the name group for the group file. See the note on 
GROUP files at the beginning of this section. 



b or I 



(optional) name of Base Library to be updated. If you 
don't code the b parameter* REPMOD(S) uses the value of 
profile variable base as the name of the base library* and 
if there's no such variable defined* REPMOD(S) uses the 
name base. 



nb or nl s 

(optional) name of the New Base to receive the updated 
library* If you don't code the nb parameter* REPHOD(S) 
uses the value of profile variable newbase as the name of 
the new base library* and if there's no such variable 
defined* REPMOD(S) uses the name of the base library 
specified by the b parameter* 



un 



(optional) User Name in whose catalog the base specified 
by b/nb is to be found* if b/nb is not in the catalog of 
the current user. If you don*t code the un parameter* 
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REPMOD(S) uses the value of profile variable baseown as 

the user name from whose catalog the base is to be 

obtained* and if there's no such variable defined* 

REPMOD(S) uses the current user's catalog* 

m or width or inwidth • 

(optional) maximum Width of the input modules* 

lock or nolock ? 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates! 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the $.&t&uL£ 
action when the base being updated is in another user's 
catalog* If you don*t code either of the lock or nolock 
&£XS» interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there's no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file ffliist be in the same catalog as the base 
being updated* If the Interlock file cannot be found* the 
procedure aborts* 

batch job parameters s 

These parameters are described in section 1*7 - M S€S 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure Is to run in local mode* but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 



msg or nomsg : 

these (optional) &£¥£ control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Examples of REPMODfS) Usage 

ses.repuod (hertz* maxwell* marconi)* b*radio* nomsg 

* END REPHOD GROUP -> RADIO 

This example shows three modules being collected onto a group 

file group (the default)* replaced on the base called radio* Since 

the nomsg &e.y. Is coded* no Informative messages are output during 
the run of REPMOD* 

ses.repmods (grab* hold) b*zilch g*temp w«80 lock msg 

* GRAB -> TEHP 

* HOLD -> TEMP 

* LOCKING ZILCH VIA INTRLOK 

* ZILCH LOCKED 

* REPLACING/ADDING NODULES ON ZILCH 

* NEW BASE ON SESTMPB 

* NEW BASE NOW ON ZILCH 

* SESTHPB PURGED 

* BASE ZILCH UNLOCKED 

* END REPNODS TEMP -> ZILCH 

This example shows two modules being replaced on the base zilch 
through a group file temp* The width of the input lines Is limited 
to 80 (ASCII) characters (because of the w parameter). Because the 
lock ii£2 was coded* the base is locked during the run using file 
Intrlok (the default)* Informative messages are output during the 
REPMODS run because the msg &£* was coded* 
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If you are creating a brand new base from scratch* you use 
REPMOD(S) slightly differently from the normal case* in that you 
code a b (base) parameter aQ^ an nb (new base) parameter* but the b 
parameter refers to a non existent base* as in this example J 

ses*repmods (york»hunt) b»nonsuch nb^newstuf 

* YORK -> GROUP 

* HUNT -> GROUP 

* CREATING NEW BASE NEWSTUF 

* NEW BASE ON NEWSTUF 

* END REPMODS GROUP -> NEWSTUF 
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REPMQDCS) takes modules from a group file (which* as shown In the 
diagram* could well have come from the oid base in the first place)* 
and replaces (or adds) them to produce either a completely new base* 
or rewrites the result over the old base* 
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COLLECT is useful in conjunction with source text maintenance 
procedures such as REPMOD(S). COLLECT builds a group file by 
COLLECTing modules of a specified type* adding in the module name 
and COMMON lines* and copying the modules to a group file. Also* 
COLLECT can accumulate members of different types onto the group 
file* and so may be used in conjunction with the library management 
procedures described in another section* Parameters to COLLECT 
are : 



m or mem or mems or member or members : 

{optional) list of Members to be accumulated onto the 
group file. When used in conjunction with other Source 
Code Maintenance procedures* COLLECT assumes that files 
specified with the m parameter already have the deck name 
as the first line of the file (and COMMON as the second 
line for a common deck), fclfttfi * if the file specified by 
the m parameter is a mu 1 1 1 record file* COLLECT dues, 
gather all records in the file. This capability is aoJt 
available with the c and r parameters as it is not truly 
applicable in those cases. 



c or com or oplc ? 

(optional) list of COMmon modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files* and so COLLECT places the module name 
and COMMON lines at the start of the module. 



r or reg or op! s 

(optional) list of REGular modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files* and so COLLECT places the module name 
line at the start of the module* 



g or group * 

(optional) name of group file onto which the member (s) or 
module(s) are to be accumulated. If you don't code the g 
parameter* COLLECT uses the value of profile variable 
group* and if there's no such variable defined in your 
profile* COLLECT uses the filename group. 
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msg or nomsg * 

these (ootional) Ilsxs. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



ses< 


.collect c*fcdc» icl» 


* 


CDC/COH -> ACRONYM 


* 


ICL/COM -> ACRONYM 


* 


IBM/COM -> ACRONYM 


* 


SDC/REG -> ACRONYM 


* 


IFS/REG -> ACRONYM 


* 


CSC/REG -> ACRONYM 


* 


END COLLECT ACRONYM 



Examples of COLLECT Usage 

ib«)> r*(sdc> lfs» csc)» g»acronym 



This example shows six straight text files being collected onto a 
group file acronym. The first three are specified as common modules 
Cthe c parameter)* so COLLECT adds the module name and COMMON lines 
at the front of the file before adding it to the group file. The 
last three are specified as regular modules (the r parameter)* so 
COLLECT adds the module name line at the start of each one before 
adding it to the group file. 
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Dtnta.fiaM-fl£-i;aLL£CI-aLac£iaiQfl 



R or REG or QPL 
regular — - 
nodules 

xssssxssssissas 



ssxsitsastssass 

C CCQN or OPLCJ 
— - common 
modules 

xxssxtstsscsm 



/ V V / 

COLLECT 
{make a 

group} 

— ™+— - 



G or GROUP 
file containing 

modules 



As shoan in the diagram* COLLECT takes files designated as either 

regular or common modules* and gathers them onto a group file. 

COLLECT can also just gather up records which already have header 
information in them (the m parameter). 
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GENCOMP generates a compile file for a module or a group of 

modules* Only regular modules can be GENCOHPed. The GENCOMP 

process resolves calls to common modules (including afiStftd calls) 
according to the following "compile file" directives s 

♦CALL module 

This directive unconditionally calls the specified common 
modu I e. 

*CALLC modu! e 

This directive only calls the specified common module if 
it has not already been called within the current regular 
module. The information about which common modules have 
been called is cleared at the end of processing each 
regular module. 

♦IFCALL name module 

This directive only calls the specified common module if 
the specified name has been defined (see the define 
parameter described below). 

♦NIFCALL name module 

This directive only calls the specified common module if 
the specified name has not been defined Csee the define 
parameter described below). 

GENC3MP permits the specification of a list of alternate bases 
from which to resolve common deck calls Cor in which to find modules 
to be GENCOHPed). Also* a source file may be specified which 
contains source for modules (or common modules) to be used in the 
GENCOMP process. In addition* correction sets may be applied prior 
to the compile file being generated. 

When generating the compile file* MADIFY searches for decks in 
the following order * 

1. If the SF parameter is coded* the specified file is searched. 

2. If the AB parameter is coded* the specified files are searched 
from right to left. 

3. If the CYBCCMN/CYBICMN parameter is coded* the designated 
common deck base is searched. 

4. Finally* the base specified by the B parameter is searched. 
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Parameters to GENCQMP are s 



in or all : 

This {optional) parameter specifies a list of modules 
(including ranges of modules) for which the compile file 
is to be generated. If the all &£* is coded* a compile 
file for Alt of the (regular) modules in the specified 
base(s) are produced. If you don't code the m parameter 
at all* you must code the sf parameter (see below). 



cf 



b or I 



(optional) name of the Compile File to be generated. If 
you don't code the cf parameter* GENCOMP writes the 
compile file to a file called compile* 



(optional) name of Base Library from which to generate the 
compile file. If you don't code the b parameter* GENCOMP 
uses the value of profile variable base as the name of the 
base library* and if there's no such variable defined* 
GENCOMP uses the name base* 



un s 

(optional) User Name in whose catalog the base specified 

by b may be found. If you don't code the un parameter* 

GENCOMP uses the value of profile variable baseown as the 

name of the base library* and if there's no such variable 

defined* GENCOMP assumes that the base is in the current 
user's catalog* 

ab or a I ? 

(optional) list of Alternate Bases from which to satisfy 
calls to common modules. The ab parameter may be coded as 
a multi valued list of sublists* Each element of the 
value list is either a single name* in which case it 
refers to the name of an alternate base already assigned 
to the job* or in the current user's catalog* ox an 
element is a sublist* in which case* the last sub element 
in the sublist is a user name in whose catalog the bases 
referred to by the other sub elements of the sublist may 
be found. The example at the end of this description 
should (with luck) make this clear* 
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sf 



(optional) name of a Source File containing source text 
for one or wore modules or common modules that are to be 
used in place of or in addition to the modules on the 
specified base(s)» If the sf parameter is given* the file 
it specifies is the object of a *CREATE directive to 
MADIFY* tlatfi s that if you don't code the m parameter 
(described above)* GENCOMP assumes that the file specified 
by the sf parameter contains one (regular) module and 
that* unlike the norma! case for a MADIFY source module* 
its first line is not the module name but is the first 
line of data in the module (in this case a default module 
name of SESOPT is used)* If you don't code the sf 
parameter* you must code the m parameter. 



cors or c s 

(optional) name of file containing CORrection Sets to be 
temporarily applied against the base b prior to generating 
the compile file* If you code the cors parameter* GENCOMP 
uses procedure TEMPCQR to make the temporary corrections 
before generating the compile file* 



seq or noseq s 

(optional) The default for GENCOMP is NO SEQence numbers 
on the compile file* and a compile file width of 100 
(ASCII) characters* You can code noseq«value to change 
the width* or you can code seq to get SEQuence numbers at 
a width of 100 characters* or you can code seq*value to 
get SEQuence numbers at compile file width of value 
characters* You control the sequence numbers and width by 
defining the profile variables cfseq and cfwidth. 

define or def : 

this (optional) parameter specifies a name or list of 
names to be *DEFINEd for reference by the *IFCALL and 
♦NIFCALL "compile file** directives described above* 

status or sts : 

status is an (optional) parameter that is used for those 
cases where GENCOHP is being used as a building block of 
more sophisticated procedures or jobs* The status 
parameter causes GENCOMP to set one of the job control 
registers to the value zero if GENCOMP successfully 
completed* and non zero if anything went wrong during the 
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run of GENCOMP. The only values that may be coded for the 

status parameter are one of Rl> R2* R3 or EF* Any other 

value coded causes an error message to be output* and 
GENCOMP procedure aborted. 

cybccmn or cyblcmn t 

these (optional) &2V.5 specify one of SES supplied 
Alternate Bases for use in satisfying calls to common 
modules (see the ab parameter described above)* If you 
code the cybccmn &£*• the base containing CoMmoN modules 
for use by CY8IL CC programs is selected. If you code the 
cybicmn Jsfiy.» the base containing CoMmon modules for use by 
CYBIL CI programs is selected. If you don*t code either 
of these iisy.s> neither of the corresponding bases is 
selected for use in generating the compile file. 

nest or nonest : 

these (optional) lse.Y.s. control whether nested calls to 
common modules are processed or ignored. If you omit this 
parameter or code the nest &££• GENCOMP processes nested 
calls to common decks. If you code the nonest kfiv. GENCOMP 
treats nested calls as ordinary lines of text* 



msg or nomsg : 

these (optional) &e.y.s. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



nodrop 



If this (optional) k.e.v. is coded* it specifies that an 
"unknown" common deck (one that couldn*t be found during 
the compile file generation) is not considered to be an 
error* otherwise it Is. tifits • other errors are also 
ignored If nodrop is given* so use this feature at your 
own risk. 
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Examples of GENCOMP Usage 

ses.gencorap nexlinr 

* GENERATING COMPILE FILE NEXLINR 

* END GENCOMP COMPILE <- OURBASE 

This example shows the simplest use of GENCOMP* generating a 
compile file for a module nexlinr* Since the a parameter of GENCOMP 
is the first positional parameter* we can omit the m keyword* There 
is no base specified in the example since there is a directive 
I ike s 

\ base * «QURBASE» 

in our profile* When GENCOMP has finished* the generated compile 
file appears on the file compile. The next example is more 
complicated* it shows the use of multiple modules and alternate 
bases used to generate the compile file* 

ses*gencomp fasterlx* obe I i x. • get af i x) * b*gaul* ab»( hasp* * . • • 
*•? (grasp* cics* power* Ir69). milos} 

* GENERATING COMPILE FILE COMPILE 

* ENO GENCOMP COMPILE <- GAUL 

This example generates a compile file for modules asterlx* and 
all modules obelix through getafix in the base called gaul. 
Alternate bases hasp and milos are to be obtained from the current 
user's catalog* and alternate oases grasp* cics and power are to be 
obtained from the catalog of user Ir69* The compile file appears on 
file compile* The example also illustrates the use of continuation 
tines* showing the multi valued ab parameter split across lines* 

ses*get»ods (special* general}* b*theory| multed; •• 
••? gencomp (special* general}* cf*aibert* sf»group* •• 
••? b*theory* define* lorentz* seq*79 

* GENERATING COMPILE FILE ALBERT 

* ENO GENCOMP ALBERT <- THEORY 

In this example modules special and general are extracted from 
base theory onto file group and edited* Then a compile file is 
generated for the edited version of the modules (via the sf 
parameter) with the lorentz "option 1 * defined* The resulting file 
albert will have sequencing information to the right of column 79* 
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GENCOMP generates a compile file for modules which may come from 
off the base (the m parameter)* or from a source file (the sf 
parameter), or from both places. The ab parameter specifies a fist 
of alternate bases to be used to get common decks from* A temporary 
correction set may be applied (the cors parameter) via the TEMPCOR 
procedure before generating the compile file. 
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GENCQR and GENCORS are synonyms for a procedure that GENerates a 
CORrection Set for a module. Parameters to GENCORCS) are s 



m i 



b or I 



un 



name of the Module within the base library b for which the 
correction set is to be generated. Also* m is the default 
naie of the file (either focal or in your catalog) which 
contains the new version of the module (see the sf 
parameter described below). 



(optional) name of Base containing the module specified by 
m for which the correction set is to be generated* If you 
don't code the b parameter* GENCORCS) uses the value of 
profile variable base as the name of the base library* and 
if there's no such variable defined* GENCORCS) uses the 
name base* 



(optional) User Name where the base library specified by b 
is to be found. If you don f t code the un parameter* 
GENCORCS) uses the value of profile variable baseown as 
the user name in whose catalog b is to be found* and if 
there's no such variable defined* GENCOR(S) assumes that 
the base library is in the current user's catalog. 



cors or c s 

(optional) is a file containing a CORrection Set to be 
applied against the base b before the module m is 
extracted* If you code this parameter* SES procedure 
TEHPCOR is used to apply a TEMPorary CORrection set. Note 
that TEMPCOR doesn't actually alter the base* the 
correction set is only applied for the duration of the 
GENCORS run. 



ncors or nc J 

(optional) name of file to receive the New CORrection 
Set* If you don't code the nc parameter* GENCORCS) uses 
the name ncors for the new correction set file. 
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id 



(optional! IDent name for the GENCORS *IDENT directive in 
the generated correction set* id can be any character 
string that forms a valid MODIFY correction identifier* 
If you don't code the id parameter* GENCORS generates a 
unique correction set identifier. 



sf 



this (optional) parameter specifies the name of the file 
containing the new version of the module. If you don f t 
code the sf parameter* GENCOR(S) uses the name specified 
by the m parameter as the Source File name. 

Is or ignorls : 

these (optional) lisis specify whether or not to IS&OEe 
Leading Spaces on lines being compared* The default action ' 
Is to recognize leading spaces (the Is option)* If you * 
code the Ignorls isai* GENCOR(S) ignores leading spaces on 
text I i nes* 



fl 



(optional) parameter to increase the field length* If you 
don't code the £1 parameter* GENCOR(S) defaults to a field 
length of 100K* 



msg or nomsg : 

these (optional) Isft^a control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 



Example of GENCORtSI Usage 

ses.gencors m»nice* b*neat* un»by73» nc»corset 

* GENERATING CORRECTION SET FOR NICE ON CORSET 

* END GENCORS NICE -> CORSET 

This example shows a correction set being generated for module 
nice* The original module is in base neat in the catalog of user 
by73* 
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The picture shows the flow of GENCOR(S). The file containing the 

new module M Is In the user's catalog. The old version of the 

module is In the base B. An optional temporary correction set 

(CORS) may be applied if desired* In which case GENCOR(S) uses the 

TEMPCOR procedure to apply the correction set before generating the 



new correction 
p arameter. 



set* which appears on the file specified by the ncors 
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TEMPCGR makes temporary corrections to a base library* without 
permanently updating the library* providing checkout of the 
corrections applied before permanent modifications are made. 
Parameters to TEHPCOR are : 



b or I 



un ? 



name of Base Library against which the corrections are to 
be applied* If you don't code the b parameter* TEMPCOR 
uses the value of profile variable base as the name of the 
base library* and if there's no such variable defined* 
TEMPCOR uses the name base* 



(optional) User Name in whose catalog the base library 
specified by b may be found* If you don't code the un 
parameter* TEHPCOR uses the value of profile variable 
baseown as the user name where b may be found* and if 
there's no such variable defined* TEMPCOR uses the current 



user's catalog* 



cors or c s 

name of file containing the CORectionS to be applied 



against b* 



msg or nonsg : 

these (optional) &£¥S, control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Example of TEMPCOR Usage 

ses.tempcor b»hisbase> un*nr06» ccorsets 

* CREATING TEMPORARY BASE 

* TEMPORARY BASE NOW BEING USED 

* END TEMPCOR CORSETS ~> HISBASE 

This example shows the correction set corsets being applied to 
the base hisbase* The base hisbase is left local to the job* such 
that further references to hisbase actually use a temporary copy* 
and not the original* 
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MODIFY is intended to take a correction set file and update a 
base library with the correction sets contained therein. Parameters 
to MODIFY are 5 

cors or c or i s 

name of file containing the CORrection Set(s) to be 
applied against the base specified by the b parameter* If 
you don't code the cors parameter* MODIFY uses the name 
cors* 



b or I s 

(optional) name of Base to be updated from the correction 
set file* If you don't code the b parameter* MODIFY uses 
the value of profile variable base as the name of the 
base* and if there's no such variable defined* MODIFY uses 
the default name base* 



nb or nl 5 

(optional) name of New Base to be created when the update 
has been completed* If you don f t code the nb parameter* 
MODIFY uses the value of profile variable newbase as the 
name of the new base* and if there's no such variable 
defined* MODIFY writes the new base over the old base 
specified by the b parameter. 



un : 

(optional) User Name in whose catalog the base specified 
by b/nb is to be found* if b/nb is not in the catalog of 
the current user. If you don't code the un parameter* 
MODIFY uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtained* 
and if there's no such variable defined* MODIFY uses the 
current user's catalog* 

lock or no lock i 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the dfifauli 
action when the base being updated is in another user's 
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catalog* If you don't code either of the lock or nolock 
&sy.S» interlocking Is controlled by the I ok mode profile 
variable* Refer to the Introductory sections of this 
chapter for Information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename! If there's no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file iJist be in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 

batch Job parameters s 

These parameters are described in section 1*7 - *»SES 
PROCEDURES RUN AS BATCH JOBS'** The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayfile parameter Is not used by this 
procedure* 



msg or nomsg * 

these (optional) &e.y.s control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 



Example of MODIFY Usage 

ses*modify b=dusbase ccorsiib 

* APPLYING CORSLIB TO OUSBASE 

* NEW BASE ON SESTNPB 

* NEW BASE NOW ON DUSBASE 

* SESTNPB PURGED 

* END MODIFY CORSLIB -> DUSBASE 

This example shows a correction set file called corsllb applied 
against a base library called dusbase. 
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CATBASE Is used to display a list of the modules in a base 
library, CAT8ASE outputs the modules list in a condensed format* 
four modules per line* shoeing only the module names and their 
type* Parameters to CAT8ASE are s 

b or I : 

(optional) name of Base Library which is to have its 

module names displayed* If you don f t code the b 

parameter* CATBASE uses the value of profile variable base 

as the name of the base* and if there f s no such variable 

defined* CATBASE uses a file name of base* 



un 



o s 



(optional) User Name in whose catalog the base specified 
by the b parameter is to be found* If you don*t code the 
un parameter* CATBASE uses the value of profile variable 
baseown as the user name* and if there*s no such variable 
defined* CATBASE uses the current user's catalog* 



(optional) name of file to receive the Output from 
CATBASE* If you don*t code the o parameter* CATBASE 
places the module list on file output* 



short or long : 

these (optional) fcais. determine the format of the output 

from CATBASE* If you omit this parameter or code the 

short &e.i* CATBASE produces its output in the form shown 

in the example below* If you code the long &£¥• CATBASE 

produces its output in the same format as the NOS utility 
CATALOG* 
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4.8 CAT8ASE - PRODUCE LIST OF MODULES IN A BASE LIBRARY 



Example of CATBASE Usage 



ses.catbase b»dusbase un*vb55 



DOUSERH..QPL 
DUSCGOM..QPLC 
DUTEXTP..OPLC 
DUGQODY..OPLC 
DUSYNTX..OPLC 
OUUPDAT..OPLC 
* END CAT8ASE 



OUINTRO..QPLC 
DULIBRH..OPLC 
DUMAUB..OPLC 
DUPRQFL..OPLC 
OUAQUIR..QPLC 
QPL......OPLO 

OUSBASE 



DUPRINT..OPLC 
DUFXLEM..OPLC 
OUMULTI..OPLC 
DUMOOES..OPLC 
DUXTRAC..OPLC 



DUFQRMT..OPLC 
DUCQHPL..OPLC 
0UCONVS..OPLC 
OUHESGS..QPLC 
DUOOMSG,.OPtC 



This example shows CATSASE output for base library dusbase in the 
catalog of user vb55. Regular modules are identified by the type 
code QPL# and common modules are identified by the type code OPLC. 
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4.9 LISTMOD - LIST CONTENTS OF BASE 



4 . 9 LI^QQ-=_USI_£QtiIEi!iIS..Q£_a £SE 

LISTMOD performs two wain functions s to show you what's in a 

base* and to get a printout of the modules in the base if 

necessary. LISTMOD first generates a cross reference of the base* 

showing which modules call which modules* and which modules are 
called by which modules (LISTMOD uses procedure XREFMOD to generate 

the cross reference - see the description of XREFMOD if you're 

Interested)* Lastly* IISTMOO generates a printout of all modules or 

common nodules in the base — you can suppress this if you only want 

the cross reference without the whole base's contents. Parameters 
to LISTMOD are : 



b or I 



o : 



(optional) name of Base to be processed* If you don't 
code the b parameter* IISTMOO uses the value of profile 
variable base* and if there's no such variable defined* 
LISTMOD uses the default name base. 



(optional) name of file to receive the Output from 
LISTMOD. If you don't code the o parameter* a scratch 
file is used for the output and is returned once it has 
benn printed. If you code the o parameter and LISTMOD is 
run in local mode, the output Is placed on the specified 
file and is aa£ printed unless the print parameter is 
given. 



(optional) User Name in whose catalog the base specified 
by b is to be found. If you don't code the un parameter* 
LISTMOD uses the value of profile variable baseown* and if 
there's no such variable defined* LISTMOD uses the user 
name of the current user. 



batch job parameters : 

These parameters are described in section 1.7 - W SES 
PROCEDURES RUN AS BATCH 40BS W . The default for this 
procedure is to run in batch mode* but it can be run in J 
local mode. The dayfile parameter is not used by this * 
procedure. 
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print ? 

(optional) indicates ho* the output of LISTHOO is to be 
printed. For the print parameter you may code any of the 
parameters to procedure PRINT. If you don*t code the 
print parameter at all* LISTMOD prints one (1) copy of the 
output on the ASCII printer. 

short or common s 

these (optional) &£¥5 control which modules are listed 
following the cross reference of the base. If you omit 
this parameter* LISTHOO lists the source for all modules 
in the base. If you code the common liex* LISTMOD lists 
only the common modules from the base. If you code the 
short &££? no modules are listed (i.e.* only the cross * 
reference is produced). * 



Examples of LISTMOD Usage 

ses.Hstmod pr lnt*copies»3» short 

11.17.34. SUBMIT COMPLETE. 40BNANE IS AVOPBUG 
* JOB LISTMOD SUBMITTED 

This example shows LISTMOO processing the base whose name is 
contained in profile variable base. Three copies of the short list 
(cross reference only) are produced. LISTMOO is run in batch* 
rather than interactively. Running LISTMOD in batch is the 
preferred mode* since it uses rather a large amount of resources. 



ses.Hstmod b*cidbase* o*ci dprin*..... 

• •? pr int»(copies*2* h*» I atest/versi on of/cidbase 1 ) 
10.19.57. SUBMIT COMPLETE. 40BNAME IS ACULBXG 

* JOB LISTMOD SUBMITTED 

This example shows LISTMOD run in batch to produce two printouts 
of the cross reference of base cidbase* plus the text of ail the 
modules in cidbase. 
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SORTMOD rearranges a base such that all the modules appear in the 
base in alphabetical order. This is a very useful facility* for 
when a base becomes large and has a large number of modules in it* 
it»s easier to find modules in the base if they're in some regular 
order. Parameters to SORTMOD are s 



b or I 



(optional) name of Base to be sorted. If you don't code 
the b parameter* SORTHQD uses the value of profile 
variable base* and if there's no such profile variable 
defined* SORTMOD uses the name base* 



nb or nl t 

(optional) name of New Base to be created at the end of 
the SORTMOD run. If you don't code the nb parameter* 
SORTMOD the value of profile variable newbase. If there's 
no such profile variable defined* SORTMOD writes the new 
base on the file specified by the b parameter. 



un 



(optional) User Name in whose catalog the base specified 
by b/nb is to be found* if b/nb is not in the catalog of 
the current user. If you don't code the un parameter* 
SORTMOD uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtained* 
and if there's no such variable defined* SORTMOD uses the 
current user's catalog. 



(optional) name of file to receive the Output of the 
programs used to run SORTMOD. If you don't code the o 
parameter* SORTMOD sets o*0* or no output. This is 
usually the desirable default* since the sort process 
generates large volumes of output. 

edtsort s 

(optional) pair of filenames representing the input and 
output files for the EDT text editor. You use edtsort to 
EDiT the SORT output to impose your own ordering on the 
modules in the base. 
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lock or nolock i 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates? 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the 4fifay.it 
action when the base being updated is in another user f s 
catalog* If you don»t code either of the lock or nolock 
JSSXS* interlocking Is controlled by the I ok mode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don*t code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there*s no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file SilSt be in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 

batch job parameters : 

These parameters are described in section 1*7 - "SES 
PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 



msg or nomsg : 

these (optional) &£¥S control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 
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4.U WIPEMOD - DELETE MODULE(S) FROM BASE 



4.11 iIEEttQa-=-aiLEI£-ttQQliLEiSl-EBQfi-&AS£ 

WIPEMOD is intended as a means of deleting module(s) from a 
base* Parameters to WIPEMOD are : 



b or I 



(optional) name of Base from which module(s) are to be 
deleted. If you don't code the b parameter* WIPEMOD uses 
the value of profile variable base as the name of the 
base. If there's no such profile variable defined* 
WIPEMOD uses the name base as the name of the base. 



nb or n I s 

(optional) name of New Base to be created at the end of 
the WIPEMOD run. If you don't code the nb parameter* 
WIPEMOD uses the value of profile variable newbase as the 
name of the new base. If there's no such profile variable 
defined* WIPEMOD places the new base back over the old 
base specified by the b parameter. 



un s 



(optional) User Name in whose catalog the base specified 
by b/nb is to be found* if b/nb is not in the catalog of 
the current user. If you don't code the un parameter* 
WIPEMOD uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtained* 
and if there's no such variable defined* WIPEMOD uses the 
current user's catalog. 



c or con or oplc : 

(optional) list of CONmon module(s) to be deleted. 



r or reg or opl 5 

(optional) list of REGul ar or OPL module(s) to be 
del eted. 



lock or no lock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates* 
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coding a filename for the lock parameter determines the 
naie of the interlock file* Interlocking is the slfifauli 
action when the base being updated is in another user f s 
catalog* If you don»t code either of the lock or nolock 
iiaiS* interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there f s no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file ms£ be in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts. 
batch Job parameters * 

These parameters are described in section 1*7 - **$ES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but It can be run in 
batch mode* The dayfile parameter is not used by this 
procedure. 



msg or nomsg : 

these (optional) kfilS control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Example of WIPEMOD Usage 

ses* wipemod mybase c*<cdecka» cdeckb) r* < ma i n. .street • comd) 

* DELETING MODULES FROM MYBASE 

* NEW BASE ON SESTMPB 

* NEW BASE NOW ON MYBASE 

* SESTMPB PURGED 

* END WIPEMOD MYBASE 

This example of WIPEMOD deletes common modules cdecka and cdeckb 
from the base mybase. It also deletes regular modules main through 
street inclusive* and regular module comd. The example illustrates 
the sort of informative messages output by WIPEMOD. 
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4.12 XREFMQD - CROSS REFERENCE OF A BASE 



* . 1 2 KREEaatt-=-C&QSS-&EEE&EiiCE-QE- A-fi ASE 

XREFMQD produces a cross reference listing of a base. (XREFMQD 
Is primarily intended as a "building block** for other procedures. 
In particular* see the description of the LISTHOD procedure which 
runs XREFMOD as a batch job.) 

Optionally* a single module (deck) name can be specified for 
which are produced (instead of the normal output listing) a list of 
the regular modules that reference (call) the module either directly 
or indirectly (see the description of the m parameter for more 
information on this feature). 

In the normal (i.e. not the single module option) mode of 
output* XREFMOD produces for each HOOule (deck) the following 
information * 

1. the name of the deck 

2. the date on which the deck was created 

3. the type of deck (see deck categories described below) 

4. the number of lines in the deck 

5. the position of the deck in the base 

6. a list of all the decks that reference (call) this deck 

7. a list of all the decks that are referenced (called) by this 
deck 

Items 2 through 5 are replaced by a "flag** if the deck is 
"external** to the base being cross referenced. An external deck is 
one which is referenced (called) by one or more decks in the base 
but which is not itself contained in the base. A separate list of 
all the external decks is produced following the main deck list. 

In items 6 and 7> a deck name may be preceded by f I f indicating 
an Indirect reference* and/or by f *» indicating an external deck. 

AH deck lists are arranged in alphabetical order. The page 
width and page length are selectable via parameters. 
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Modules are categorized according to the following criteria s 



• £a£&3a££_Xg&£ * Cxitfitia* * 

• • • 

• i * 


• i * 

1 * i 

• COMMON * common deck ! 

• « * 


* • • 

■ • t 

5 MODULE * first program line is a MODULE line 5 

* • § 

* • « 


• * • 

% IDENT \ first program line is an IDENT line J 

f • 4 
• « * 


* a * 
at • 

J PROGRAM J first program line is a PROGRAM line % 

• t • 
« * t 


* * • 
■ * * 

* SESPRQC * first two characters of the first program line S 
1 • are f \ •* that is* the SES processor master < 

* * control character followed by a space* * 

* • • 

* * • 


• * > 

I TXTFORM S first character of the first line is a reverse 5 

5 i slant (\) \ 

• * • 
< * % 

• • t 
t * i 

• KCL J first character of the first line is an asterisk X 
J \ 1*) and not immediately followed by "CALL'S * 

% I "CALLC", "IFCALL". or "NIFCALL". 1 

• * * 
i * t 


• * a 
it a 

5 CCL J first line is a .PROC line 1 

• « i 

it * 


• • • 

* • * 

J UNKNOWN J <you guessed it) none of the above 3 

a a a 
at a 
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* Up to five lines are examined if the first separator character 
of the previous line(s) is a double quote (**) or a question 
mark (?)* 

Parameters to XREFMOD are s 

b or I s 

(optional) name of Base Library for which the cross 
reference is to be generated* If you don't code the b 
parameter* XREFMOD uses the value of profile variable base 
* and if there's no such variable defined* XREFMOD uses 
the default name of base* 



un 



(optional) User Name in whose catalog the base specified 
by the b parameter is to be found* If you don't code the 
un parameter- XREFMOD uses the value of profile variable 
baseown as the user name* and if there's no such variable 
defined* XREFMOD assumes that the base is in the current 
user's catalog* 



(optional) name of file to receive the Output from the 
cross reference run* If you don't code the o parameter* 
XREFMOD sends the output to file OUTPUT* 

m or mod * 

(optional) name of a module (possibly external) for which 
a list of the regular modules that reference (call) it 
either directly or indirectly are produced* Each module 
name Is written on a separate line with a space in column 
1* the module name in columns 2 through 8 (left justified* 
space filled* with letters in upper case) and a period 
(*) In column 9* The module names are written in 
alphabetical order* 

pw or pwidth : 

this (optional) parameter specifies the Page Width for the 

cross reference listing* If you code this parameter* you 

must give a value of at least 70* If you omit the pw 

parameter* XREFMOD uses a page width of 132* 
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pi or p length s 

this (optional) parameter specifies the Page Length for 
the cross reference listing* If you code this parameter* 
you must give a value of at least 20* If you omit the pi 
parameter* XREFHQD uses a page length of 60* 
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4,13 GETCOHN - ACQUIRE CY8IL COMMON DECK LIBRARY 



GETCOHN acquires the latest SCU or MADIFY version of the CYBIi CC 
or CI common deck library as a local file named either CYBCCMN of 
CYBICHN as is appropriate* Parameters to GETCOHN are s 

mad or scu s 

these (optional) iiajts. indicate which format of the CYBIL CC 
or CI common deck library is desired* If you code the mad 
&e.y,* the MADIFY formatted version of the common deck 
library is made local* If you code the scu key. or do not 
code either of these keys* the SCU formatted version of the 
common deck library is made local* 

cc or els 

these (optional) &£*£ indicate which version of the CYBIL 
common deck library is desired* If you code the ci fcfiy.* the 
SCU or MADIFY formatted CYBIL CI common deck library is made 
local* If you code the cc &£¥• or code neither of these 
keys* the SCU or MADIFY formatted CYBIL CC common deck 
library is made local* 

You may also define PROFILE variables to override the default 
file assignments for the various forms of the CYBIL common deck 
library* For the CYBIL CC version the PROFILE variables should be s 

ccmn CYB£CMN in HADXFY format 

ccmnun owner of * ccrnn 1 

ccscu CYBCCMN in SCU format 

ccscun owner of f ccscu* 

For the CYBIL CI version* the PROFILE variables should be : 

icmf* CYBICHN in MADIFY format 

icmnun owner of Mean 1 

icscu CYBICHN in SCU format 

icscun owner of Mcscu* 



Examples of GETCOHN Usage 
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4,13 GETCOMN - ACQUIRE CYBIL COMMON DECK LIBRARY 



ses.getcoran 

* SCU VERSION OF CYBCCMN MADE LOCAL 



ses.getcomn mad ci 

* MADIFY VERSION OF CYBICMN MADE LOCAL 



The first example shows GETCOMN acquiring the SCU version of 
CYBCCMN (both parameters take their defaults)* and the second 
example shows how to acquire the MADIFY version of CYBICMN. 

tlQtfi • please ensure that you RETURN the common deck library when 
you're finished with it* 
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SES supplies a comprehensive set of procedures to manage multi 
record filest using the NOS LIBEDIT utility as a basis. It»s 
assumed that you're fairly familiar with the ideas of multi record 
files and LIBEDIT* otherwise SES can't really provide a substitute 
for knowing what you're doing* The terminology that SES procedure 
descriptions of library management use are as follows s 

LIBRARY A collection of records in a file. All SES library 
management procedures use an I parameter to refer to a 
Library. 

MEM8ER A single record in a library file* or a file containing a 
member which Is added to or replaced on a library* All SES 
library management procedures use an n parameter to refer 
to MEMBERm* 

GROUP a collection of member(s) that occupy one record per member 
on the file. 
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GETMEMCSI GET MEHberS ayfc o.£ a library aota a group file. The 
members appear one per logical record* 

REPNEMCS) REPIace or add MEMberS on a library. You also use 
REPMEHCS) in a special «ay to create a brand new library 
from scratch* 



REPULIB REPIace or add members on a User Library. 

COLLECT collect a group of members onto a group file. 

CATLIB CATatog a LIBrary to display the names and the types of 
members in the library* in short form output. 

LISTMEH LIST HEHbers. LISTMEH generates a catalog of all the 
members on a library* and optionally prints every TEXT 
member from the library. 

SORTMEM SORT MEMbers in a library. The library is arranged so 
that all members of the same type appear together. 
Within each member type* the members are sorted into 
alphabetical order. 

SRTULIB SoRT members in a User LIBrary. 

WIPENEM WIPE <deiete) NEMbers from a library. 

WIPULIB WIPe (delete) members from a User LIBrary. 

LIBEOIT use the LI8E0IT utility directly. 
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This section introduces the parameter naming convention that's 
common to most of the procedures in the library management system. 

I or b name of Library on which the operations are to be 
performed* 

n stands for Memberls)* 



9 or group name of file upon which a GROUP of members are 
accumulated when adding or replacing members on a 
library* or when members are extracted from a 
library* A group file contains one member per logical 
record* 



nl or nb name of a New Library or New Base# used in those 
procedures that perform operations that permanently 
alter a library* requiring that a new library be 
created* An explanation of the method used to update 
a library is contained in a subsequent section* 
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The variables described below way be declared in your PROFILE in 
order to establish default information for the parameters of the 
library management procedures* 

lib name of library where members are to be found or replaced* 

Mbown user name in whose catalog the library is to be found* 

newlib name of new library for those procedures which update a 
library* thereby creating a new one* The default name for 
newlib is the same name as the old library* 

group used by all procedures to designate a group file* or a file 
containing one module per logical record* The default name 
for group is group* 

sestmpl used by all of the procedures that update libraries to 
specify the temporary library file during the update 
process* The default name for this file is sestmpl. 

lokmode determines the interlocking action when updating a 
library* The lokmode variable may be set to •LOCK* Clock 
by default unless the nolock parameter is coded on the 
procedure) or •NOLOCK' {no lock by default unless the lock 
parameter is coded on the procedure)* 

intrlok used by all of the procedures that update libraries or 

bases to specify the interlock file to be used during the 

update process* The default name for the interlock file is 
intrlok* 

nx used by all of the procedures that update User LIBraries to 
specify whether a cross reference of entry points is to be 
included in the library. If nx is set to any non-null 
value* the entry point cross reference is jxQt included by 
default* otherwise it is* 
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Some of the library management procedures physically alter a 

library* requiring that a new library be created* The process is 

common to all such procedures* and Is as follows : 



If you code both the 1 and nl parameters* new library is created 
simply by performing the required operations on the old library* and 
writing the newly created library onto the file specified by the nl 



If you code only the I parameter* update takes place in two 
stages* The updating operation is performed and the new library 
writen to a file called sestmpl <SES TeHPorary Library)* sestmpl is 
then physically copied back over the file specified by the I 
parameter* and finally sestmpl is purged* 

Note that if the file specified by the nl {or I if nb is omitted) 

does not already exist* a DIRECT access READ mode file is DEFINEd 

for the library {this* of course* can only be done if the owner of 
the library is the current user)* 

Note that if anything goes wrong during an updating run* the 
original library is always left intact* and only the new library or 
sestmpl is potentially incorrect* This means that you can recover 
by purging the new library or sestmpl and starting the run again* 
If something goes wrong fcfifar.fi the library appears on sestmpl* 
original library is intact* and sestmpl may be purged* whereas If 
something goes wrong a£ifi£ the new library is on sestmpl* that is* 
during the "rewrite** phase of the update* it is sestmpl that is 
safe* and the old library that is wrong* In this case* you may use 
the REWRITE procedure to do the rewrite again* or alternatively* you 
may just purge the old library and then change the name of sestmpl 
to be the library name. 
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When updating a library you can interlock the update so that only 
one user at a time can update the library* Those procedures that 
update a library are set up so that if the library to be updated is 
in another user's catalog* the library is interlocked by default. 
You can override default actions by defining a lokmode variable in 
your profile* or by coding a lock or nolock &£,% on the procedure* as 
shown In the diagram on the next page* 

Interlocking of a library is done via an interlock file* Such a 
file nisi be a fil&ECI access file ia t u & S3I£ u&exi& aataiaa as th& 
lifetaci baiQfl u&4a££d» Naturally the interlock file must be a 
PUBLIC* MRITE MODE file if other users are likely to be using it* 
The default name used by the SES source code maintenance and library 
management procedures for the lock file is interlok. You can have 
an Interlock file of any name by defining the intrlok profile 
variable* or by coding a file name as a value for the lock parameter 
on the appropriate procedures. 
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5.1 GETJJEM Oj^GETMEMS 2^illtl r 2! H SI R l IL F 52S -i55££I~,.,.~«*~,...„.,..~~ 

5 • 1 fiEIHE!!.Q&.fi£I!l£lia.=.£XIgAtI-Il£flia£&ISl-E&Qll-kiaR4&3t 

GETHEHCS) is intended for extracting any number of members from a 
library onto a group file* with one member per logical record. 
Parameters to GETMEM(S) are 5 



m or all : 

If you code the all keyword* GETNEM(S) extracts ALL 
members from the library specified by the I parameter. 
Otherwise* you code the m parameter as a list of name(s) 
of Memberfs) to be extracted. The list of member(s) must 
all be of the same type fas specified by parameter 6). 
Ranges of member names may also be coded* as shown in the 
examples at the end of this description. 



9 or group * 

(optional! name of group file to receive the member(s) 
extracted from the library. If you don't code the g 
parameter* GETMEM(S) uses the value of profile variable 
group* and if there's no such variable defined* uses the 
name group for the group file. 



I or b 



un 



(optional) name of Library from which the member(s) are to 
extracted* If you don't code the 1 parameter* GETMEM(S) 
either uses the value of profile variable lib* or if 
that's undefined* GETMEM(S) uses the name Mb for the name 
of the library* 



(optional) User Name in whose catalog the library 
specified by 1 is to be found* if it isn't in the catalog 
of the current user. If you don't code the un parameter* 
GETMEM(S) uses the value of profile variable libown* and 
If there's no such variable defined* the GETMEM(S) uses 
the user name of the current user. 



status or sts ' 

status is an (optional) parameter used for those cases 
where GETMEMS) is being used as a building block of more 
sophisticated procedures or jobs. The status parameter 
causes GETMEN(S) procedure to set one of the job control 
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registers to the value zero if GETMEM(S) successfully 
completed* and non zero if anything went wrong during the 
run of G£TM£M<S)* The only values that may be coded for 
the status parameter are one of Rl* R2» R3 or EF* Any 
other value coded causes an error message to be output* 
and GETMEM(S) procedure aborted. 

text or opl or oplc or opld or rel or abs or ovl or pp or ppu or 

cos or ulib or cap or proc 5 

these (optional) k2£SL specifies the type of the meibers to 
be removed from the library. If you don't code any of 
these Jsais* GETMEM(S) assumes the members are of type 
TEXT* A description of the meanings of these rather funny 
looking keys can be found in the NOS Reference Manual 
under the description of IIBEOIT* 



Examples of GETHEM(S) Usage 

ses.getmem format l*prbcllb un«lr77 text 

* END GETMEM GROUP <- PRQCLIB 

The example uses GETMEM to get one text member called format from 
a library called proclib in the catalog of user lr?7* 

ses.gettaeni I txtcode* txtform* txthead) binary l*prgilb un«mv73 ovl 

* END GETMEM BINARY <- PRGLIB 

This example extracts a group of ovl type records from a library 
called prglib in the catalog of user mv73 and places them on a group 
file cal 1 ed binary* 

ses.getmem f comput««pl scan* ci i I ev**ci i ord) l»dbuglib rel 

* ENO GETHEM GROUP <- OBUGLIB 

This example illustrates how ranges may be coded for a 
parameter* The example extracts all rel members comput through 
plscan inclusive* and all members clilev through ciiord inclusive* 
from a library called dbuglib* and places the extracted members on 
the file called group* 
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5 . 2 &E£a£tt.a&.EE£!l£iiS-=-Aaa-Q&-&£ELAC£JlEtti£RiSi.Qtl-LIfl&Aa3C 

REPMEM and REPMEMS are synonyms for a procedure to add new 
member (s) to* or replace member(s) on a library* Mfitfi ! to add or 
replace members on a User LIBrary* for use by the CYBER loader* use 
the REPULIB procedure described below. Parameters to REPMEM(S) 
are : 

m or mem or stems or member or members * 

(optional) list of Member(s) to be added to or replaced on 
the library. If you don't code the m parameter* REPMEM(S) 
assumes that all the member(s) to be added or replaced are 
already on a file specified by the g parameter* 



g or group : 

(optional) name of a group file on which member(s) are 

accumulated as one member per logical record* If you 

don't code the g parameter* REPMEMCS) uses the value of 
profile variable group* If there's no such profile 

variable defined* REPMEMCS) uses filename group as the 
group file* 

1 or b : 

(optional) name of Library on which the member (s) are to 
be added or replaced* If you don't code the I parameter* 
REPMEM(S) uses the value of profile variable Mb as the 
name of the library* If there's no such profile variable 
defined* REPMEM(S) uses a library name of lib* 

nl or nb s 

(optional) name of New Library to be created when 
REPMEM(S) has completed its run* If you don't code the nl 

parameter* REPMEM(S) uses the value of profile variable 

newl ib* and if there's no such profile variable defined* 

REPMEM(S) writes the new library over the file specified 
by the I parameter* 



un 



(optional) User Name in whose catalog the library 

specified by I /nl is to be found* if l/nl is not in the 

catalog of the current user* If you don*t code the un 

parameter* REPMEM(S) uses the value of profile variable 
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libown as the user name from whose catalog the library is 
to be obtained* and if there f s no such variable definedt 
REPMEH(S) uses the current user's catalog* 

lock or nolock i 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the jififauii 
action when the base being updated is In another user's 
catalog* If you don't code either of the lock or nolock 
&SY.S* Interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable Intrlok is used as the 
interlock filename; if there's no such profile variable* 
the name intrlok is used as the lock filename. The 
interlock file fys.£ he in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 

batch job parameters i 

These parameters are described in section 1*7 - W SES 
PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 

rep or add or addrep or repadd : 

these (optional) Isfiis specify whether you're adding and 
replacing* or just replacing* If you're ftaiy. replacing 
member(s)* you can code the rep tsfiy.* If you omit this \l&% 
altogether* REPMEM(S) assumes that you're adding tBil 
replacing member(s) and so issues the appropriate 
directives to LIBEDIT to perform that function* 

dlr or build or nodlr or nobuild ? 

these (optional) &£v.S specify whether a directory is to be 
placed at the end of the library when REPMEM(S) finishes 
its run* Coding the dlr or build options specifies that 
you want a directory record to be added to the library* 
If you code the nodir or nobuild options* or if you don't 
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code any of these keys* REPMEM(S) doesn't add a directory 
illit if a directory already exists it is updated* 



msg or nomsg J 

these (optional) kSXS control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES*. 



Examples of REPMEMCS) Usage 

ses.repmem (first* second* third) l*herklib* build 

* FIRST -> GROUP 

* SECOND -> GROUP 

* THIRD -> GROUP 

* REPLACING/ADDING MEMBERS ON BERKLIB 

* LIBRARY NOW ON SESTNPL 

* NEW LIBRARY NOW ON BERKLIB 

* BERKLIB PURGED 

* END REPMEM GROUP -> BERKLIB 

This example illustrates REPMEM used to collect three members 
onto a group file* and then place the contents of the group file on 
a library called berklib. The example shows some of the informative 
messages that appear during a REPMEM run. 



£t£a£iaa_aJi&a_LibLa££.iiit£i_&E£8EM&l 

ses.repmem l*duamy» nl»proclib» g»newproc build 

♦ CREATING NEW LIBRARY PROCLIB 

* END REPMEM NEWPROC -> PROCLIB 

This example illustrates how to build a new library. The I 
parameter is coded as some "dummy" name that doesn't exist. The new 
members to be added are on a group file called newproc. The new 
library is created* and a directory is added because of the build 
&£]£* 
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REPULIB is a special version of REPHEN(S) to add or replace 
member (s) on a User LIBrary* LIBEDIT (the basis for these library 
management procedures) can't handle user libraries directly* so 
REPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctly* Parameters to REPULIB are : 

m or mem or mems or member or members : 

(optional) list of Member(s) to be added to or replaced on 
the library* If you don't code the m parameter* REPULIB 
assumes that all the member(s) to be added or replaced are 
already on a file specified by the g parameter. 



g or group : 

(optional) name of a group file on which member(s) are 
accumulated as one member per logical record. If you 
don't code the g parameter* REPULIB uses the value of 
profile variable group. If there f s no such profile 
variable defined* REPULIB uses filename group as the group 
file. 



I or b : 

(optional) name of Library on which the member(s) are to 
be added or replaced. If you don't code the 1 parameter* 
REPULIB uses the value of profile variable lib as the name 
of the library. If there's no such profile variable 
defined* REPULIB uses a library name of lib. 

ni or nb : 

(optional) name of Mew Library to be created when REPULIB 

has completed its run* If you don't code the nl 

parameter* REPULIB uses the value of profile variable 
newlib* and if there's no such profile variable defined* 

REPULIB writes the new library over the file specified by 
the I parameter. 



un 



(optional) User Name in whose catalog the library 

specified by I /nl is to be found* if l/nl is not in the 

catalog of the current user. If you don't code the un 

parameter* REPULIB uses the value of profile variable 

COMPANY PRIVATE 



5-14 
COC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User*s Handbook REV: AB 

5.0 LIBRARY OR MULTI RECORD FILE MANAGEMENT USING LIBEDIT 
5,3 REPULIB - AOO OR REPLACE MEMBER(S) ON USER LIBRARY 



libown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
REPULIB uses the current user's catalog* 

lock or no lock • 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates! 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking Is the PlfifayJLfc 
action when the base being updated is In another user's 
catalog* If you don't code either of the lock or nolock 
&&£&• interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable intriok is used as the 
interlock filename; if there's no such profile variable* 
the name intriok is used as the lock filename. The 
interlock file iys.£ be in the same catalog as the base 
being updated. If the interlock file cannot be found* the 
procedure aborts. 

batch job parameters $ 

These parameters are described in section 1.7 - W SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayflle parameter is not used by this 
procedure. 



rep or add or addrep or repadd i 

this (optional) jifiy. specifies whether you're adding and 
replacing* or just replacing. If you're aaix replacing 
member(s) you can code the rep jssy.. If you omit this h&X 
altogether* REPULIB assumes that you're adding and 
replacing member(s) and so issues the appropriate 
directives to LIBEDIT to perform that function. 



nx 



this (optional) kg* indicates that when REPULIB performs 
the LIBGEN portion of Its job* that LIBGEN should not 
build a cross reference of entry points in the ULIB 
record. You can set your own default for this parameter 
by defining the nx variable in your profile (any non-null 
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value causes the cross reference to qo.£ b* built). Refer 
to the LIBGEN documentation in the NOS reference manual* 



msg or nonsg s 

these (optional) kSLts. control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES' 1 . 
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5 . 4 CQLL£CI-=-COU£CI-t3£ISa£Slil-IQ-iyiLQ-4-aEfiil£.£IL£ 

COLLECT Is used in conjunction with library management procedures 
such as REPMEM(S). COLLECT is used to accumulate members onto a 
group file for subsequent processing by REPMEM<5>* LIBEOIT and so 
on* COLLECT can also be used in conjunction with source text 
maintenance procedures* to collect text modules* adding headers and 
COMMON lines if required* Parameters to COLLECT are : 

m or mem or mens or member or members i 

{optional) list of Members to be accumulated onto the 
group file* tiats * If the file specified by the m 
parameter is a multi record file* COLLECT daSS gather all 
records in the file* This capability is aaJ; available 
with the c and r parameters as it is not truly applicable 
i n those cases* 



c or com or oplc : 

(optional) list of COMmon modules to be accumulated onto 
the group file* COLLECT assumes that such modules are 
straight text files* and so COLLECT places the module name 
and COMMON line at the start of the module* 



r or reg or opt ? 

(optional) list of REGul ar modules to be accumulated onto 
the group file* COLLECT assumes that such modules are 
straight text flies* and so COLLECT places the module name 
at the start of the module* 



g or group : 

(optional) name of group file onto which the member (s) or 
module(s) are to be accumulated* If you don't code the g 
parameter* COLLECT uses the value of profile variable 
group* If there f s no such variable defined In your 
profile* COLLECT uses the filename group* 



msg or nomsg * 

these (optional) &e.*s control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Example of COLLECT Usage 

ses. collect (docode* dos tat» ea tup* e I sei f > equa I) g«coders 

* DOCODE -> CODERS 

* OOSTAT -> CODERS 

* EATUP -> CODERS 

* ELSEIF -> CODERS 

* EQUAL -> CODERS 

* END COLLECT CODERS 

This example of COLLECT illustrates how it is used to accumulate 
a bunch of records onto a group file» 
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CATLIB is used to display a list of the members in a library* 

CATLIB outputs the members list in a condensed format* four members 

per line* showing only the member names and their type. Parameters 
to CATLIB are * 



I or b 



un 



(optional) name of Library which is to have its member 
names displayed. If you don f t code the I parameter* 
CATLIB uses the value of profile variable lib as the name 
of the library* and if there's no such variable defined* 
CATLIB uses a file name of lib. 



(optional) User Name in whose catalog the library 
specified by the I parameter is to be found. If you don't 
code the un parameter* CATLIB uses the value of profile 
variable libown as the user name* and if there's no such 
variable defined* CATLIB uses the current user's catalog. 



(optional) name of file to receive the Output from 
CATLIB. If you don't code the o parameter* CATLIB places 
the member list on file output* 



short or long s 

these (optional) &SV.S determine the format of the output 
from CATLIB. If you omit this parameter or code the short 
lie.** CATLIB produces its output in the form shown in the 
example below* If you code the long kay.» CATLIB produces 
its output in the same format as the NOS utility CATALOG. 



o J 
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Example of 


CATLIB Usage 




ses.catlib b*cs 


lotib un*mv69 






CSIOLIB..ULI8 


A63TQIA..REL 


A64T0IA..REL 


CATLIST..REL 


CNVCASE..REL 


CPYA REL 


C63T0IA..REL 


IATQA63..REL 


IATQA6*..REL 


IATON63..REL 


IAT0N64..REL 


IDEBUG*«.REL 


IDEBUGK.REL 


IKHISC...REL 


ISCLHSG..REL 


ISWLSYS..REL 


ISYSTIM..REL 


NCGNP....REL 




MCSCNV...REL 


MEXPR....REL 


MGET.....REL 


NGETCSP..REL 


MGETKCS..REL 


MGETSYM..REL 


MGETTOK..REL 


MLOCFIL..REL 




MPDTPVT«.REL 


MPLIST...REL 




MSTREAW^REL 


HTOKCNV..REL 


N63T0IA..REL 


N64T0IA..REL 


PKUNPK...REL 


ZIATOXC..REL 


ZXCTOIA..REL 


CSIOLIB..OPLD 




* END CATLIB 


DUSLIB 







This example shows CATLIB output for a library csiolib in the 
catalog of user mv69. The member types are as defined in the NOS 
reference manual section on LIBEDIT* 
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5 . 6 LISIH£tt-=-LlSI.£QliIEaiS-a£.Lia&ARI 

LISTMEM performs two main functions to show you what's in a 
library* and to get a printout of the TEXT members in the library if 
necessary. LISTMEM first generates a normal CATALOG which shows the 
names of all the members in the library. Lastly* LISTMEM generates 
a printout of all TEXT members in the library - you can suppress 
this if you only want the catalog without the whole library's 
contents* Parameters to LISTMEM are : 



I or b 



(optional) name of Library to be processed* If you don f t 
code the b parameter* LISTMEM uses the value of profile 
variable lib as the library name* and if there's no such 
variable defined* the LISTHEH uses the default name lib* 



(optional) name of file to receive the Output from LISTMEM 
places the output on some unique file name that It 
generates* The output doesn't default to file output 
because* if you're running LISTMEM interactively* you 
probably don't want the rather voluminous output on the 
screen* 



(optional) User Name in whose catalog the library 
specified by I is to be found* If you don't code the un 
parameter* LISTMEM uses the value of the value of profile 
variable libown* and if there isn't such variable defined* 
LISTMEM uses the user name of the current user* 



batch job parameters t 

These parameters are described in section 1*7 - **SES 
PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in batch mode* but it can be run in 
local mode* The dayfile parameter is not used by this 
procedure* 



un 



print 



this (optional) parameter indicates how the output of 
LISTMEM is to be printed. For the print parameter you may 
code any of the parameters to procedure PRINT* If you 
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don*t code the print parameter at alii LISTMEM prints one 
(1) copy of the output on the ASCII printer. 

short i 

if you code this (optional) hey.* LISTMEM only generates 
the catalog output* and suppresses the listing of all the 
TEXT members. 



Examples of LISTMEM Usage 

ses.listmem print*c«3 short 

12.34.56. SUBMIT COMPLETE* JOBNAME IS ACULARS 
* JOB LISTMEM SUBMITTED 

This example shows LISTMEM used to process a library* whatever 
name is the value of lib. Three copies of the short list (catalog 
only) are being produced* LISTMEM is being run in batch* rather 
than interactively* 

ses.listmem b»proclib o*procs pr Int* (c*2*h* 9 I atest/procl ib 9 ) 

18.12,00. SUBMIT COMPLETE. JOBNAME IS ANAPABS 
* JOB LISTMEM SUBMITTED 

This example shows LISTMEM being run in batch to produce two full 
printouts of the catalog and alt the TEXT members in the library 
proclib. The title on the listing is 'latest proclib 1 * 
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5 . 7 SQ&Iti£a-r-.iQEI-LiaaAgI-ItiIQ-4LE!iAa£Iia4t-a£Q££ 

SORTMEM rearranges a library such that ail the members of a given 
type appear in the library together* and within each type* the 
members are sorted into alphabetical order* fcjftte. * to sort a User 
LIBraryf for use by the CY8ER loader* use the SRTULIB procedure 
described below* Parameters to SORTMEM are J 



I or b i 

(optional) name of Library to be sorted* If you don't 

code the I parameter* SORTMEM uses the value of profile 

variable lib* If there's no such profile variable 

defined* SORTMEM uses the name lib* 

nl or nb * 

(optional) name of New Library to be created at the end of 
the SORTMEM run* If you don't code the nl parameter* 
SORTMEM uses the value of profile variable newlib* If 
there's no such profile variable defined* SORTMEM writes 
the new library on the file specified by the I parameter* 



un 



o : 



edtsort 



(optional) User Name in whose catalog the library 
specified by l/ni is to be found* if l/nl is not in the 
catalog of the current user* If you don't code the un 
parameter* SORTMEM uses the value of profile variable 
libown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
SORTMEM uses the current user's catalog* 



(optional) name of file to receive the Output of the 
programs used to run SORTMEM* If you don't code the o 
parameter* SORTMEM sets o*0* or no output* This Is 
usually the desirable default* since the sort process 
generates large volumes of output* 



(optional) pair of filenames representing the input and 
output files of the EOT text editor* You can use edtsort 
to EDiT the SORT output to impose your own ordering on the 
members in the library* 
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lock or nolock s 

these {optional) parameters determine whether the base 
update process is Interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the default 
action when the base being updated is in another user's 
catalog. If you don't code either of the lock or nolock 
££¥§.» interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok Is used as the 
interlock filename; if there's no such profile variable* 
the name intrlok is used as the lock filename. The 
interlock file lust be in the same catalog as the base 
being updated. If the interlock file cannot be found* the 
procedure aborts. 

batch job parameters : 

These parameters are described in section 1.7 - W SES 
PROCEDURES RUN AS BATCH JOBS*. The default for this 
procedure is to run in local mode* but it can be run in 
batch mode. The dayflle parameter is not used by this 
procedure. 



nodlr or nobuild or dlr or build : 

these (optional) keys indicate whether a directory is to 
be placed at the end of the library when SORTMEM has 
finished its run. If you code the nodlr or nobuild K&l* 
SORTMEM doesn't place a directory in the library. If you 
code the dlr or build &gi* SORTMEM does place a directory 
in the library. If you don't code any of these keys* 
SORTMEM does a build* that is* a directory is created for 
the sorted library. 



msg or nossg s 

these (optional) fcaxs, control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES*. 
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Examples of SORTMEM Usage 

ses.sortmea l=proclib batchn 
17*52.00. SUBMIT COMPLETE. JOBNAME IS ADXIBEN 

* JOB SORTMEM SUBMITTED 

This example illustrates SORTMEM being run as a batch job by 
coding the batch &£*• SORTMEM is being used to sort the file 
proclib into order* 

ses.sortmem l*berklib lock build 

* LOCKING BERKLIB VIA INTRLGK 

* BERKLIB LOCKED 

* GENERATING MEMBER LISTS FOR BERKLIB 

* SORTING MEMBER LISTS 

* EXTRACTING MEMBERS FROM BERKLIB 

* SORTING BERKLIB ONTO SESTMPL 

* NEW LIBRARY ON SESTMPL 

* NEW LIBRARY NOW ON BERKLIB 

* SESTMPL PURGED 

* BERKLIB UNLOCKED 

* END SORTMEM BERKLIB 

This example illustrates SORTMEM run while you wait* at the 
terminal. The example sho*s the informative messages output by 
SORTMEM during Its run. 
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5 • 8 i&IUUi.r.SQ£I-yS£E.Lia£AaX.I£iIQ-4LEaAa£IKAk-Q£Q££ 

SRTULIB is a special version of SGRTMEM for sorting a User 
LIBrary into alphabetical order. LIBEDIT (the basis for these 
library management procedures) can't handle user libraries directly* 
so SRTULIB uses the LIBEDIT and LIBGEN utilities to perform the 
process correctly* Parameters to SRTULIB are : 



1 or b 



(optional) name of Library to be sorted* If you don't 

code the I parameter* SRTULIB uses the value of profile 

variable lib* If there's no such profile variable 

defined* SRTULIB uses the name lib* 



nl or nb ? 

(optional) name of New Library to be created at the end of 
the SRTULIB run* If you don't code the nl parameter* 
SRTULIB uses the value of profile variable newlib. If 
there's no such profile variable defined* SRTULIB writes 
the new library on the file specified by the I parameter* 



un 



(optional) User Name in whose catalog the library 
specified by 1/nl is to be found* if 1/nl is not in the 
catalog of the current user. If you don't code the un 
parameter* SRTULIB uses the value of profile variable 
llbown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
SRTULIB uses the current user's catalog* 



(optional) name of file to receive the Output of the 
programs used to run SRTULIB* If you don't code the o 
parameter* SRTULIB sets o*0» or no output* This is 
usually the desirable default* since the sort process 
generates large volumes of output* 

edtsort s 

(optional) pair of filenames representing the input and 
output files of the EOT text editor* You can use edtsort 
to EDiT the SORT output to impose your own ordering on the 
members in the library* 
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lock or nolock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the dsfauit 
action when the base being updated is in another user»s 
catalog* If you don f t code either of the lock or nolock 
&ej£i« interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; If there»s no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file mat be in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 

batch job parameters : 

These parameters are described in section 1*7 - H SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 



nx * 



this toptional) Ss£X indicates that when SRTULIB performs 
the LIBGEN portion of its job* that LI8GEN should not 
build a cross reference of entry points In the ULIB 
record* You can set your own default for this parameter 
by defining the nx variable in your profile Cany non-null 
value causes the cross reference to qo.£ be built)* Refer 
to the LIBGEN documentation in the NQS reference manual* 



msg or nomsg s 

these (optional) tlft^s control the generation of 

informative messages by this procedure and are fully 

described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 



PROCEDURES"* 
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WIPEMEM is intended as a means of deleting memberfs) front a 
library* Hfttfi : to delete member(s) from a User LIBrary* for use 
by the CYBER loader* use the WIPULIB procedure described below. 
Parameters to WIPEMEM are : 

I or b i 

(optional) name of Library from which member(s) are to be 
deleted* If you don't code the I parameter* WIPEMEM uses 
the value of profile variable lib as the name of the 
library* If there's no such profile variable defined* 
WIPEMEM uses the name lib as the name of the library* 

nl or nb t 

(optional) name of New Library to be created at the end of 
the WIPEMEM run. If you don't code the nl parameter* 
WIPEMEM uses the value of profile variable newlib as the 
name of the new library. If there's no such profile 
variable defined* WIPEMEM places the new library back over 
the old library specified by the I parameter* 



uti 



text * 



(optional) User Name in whose catalog the library 
specified by I /nl is to be found* if l/nl is not in the 
catalog of the current user* If you don't code the un 
parameter* WIPEMEM uses the value of profile variable 
Hbown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
WIPEMEM uses the current user's catalog* 



(optional) list of TEXT member(s) to be deleted* 



oplc or com or c * 

(optional) list of OPLC Common member(s) or COMmon modules 
to be deleted* 



opt or reg or r • 

(optional) list of OPL or REGular member(s) to be 
deleted* 
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rel : 



ovl 5 



»s ? 



PPU S 



PP * 



cos i 



cap J 



proc s 



{optional) list of RELocatable binary member(s) to be 
deleted* 



(optional) list of OVerLay type meirber(s) to be deleted 



(optional) list of ABSolute type member (s) to be deleted* 



(optional) list of PPU type member(s) to be deleted* 



(optional) list of ?? type member (s) to be deleted* 



(optional) list of COS type member( s) to be deleted 



(optional) list of CAP type member(s) to be deleted* 



(optional) list of CCL (not SES) PROCedure member (si to be 
de le ted* 



lock or nolock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the dfifauli 
action «hen the base being updated is in another user's 
catalog* If you don f t code either of the lock or nolock 
&£v.s» interlocking Is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there's no such profile variable* 
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the naie intrlok is used as the lock filename. The 

interlock file mat be in the same catalog as the base 

being updated. If the interlock file cannot be found.* the 
procedure aborts. 

batch Job parameters s 

These parameters are described in section 1.7 - **SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 



msg or nomsg : 

these (optional) &£*& control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Example of WIPEMEM Usage 

ses.wipemem l»thislib* text* ( heavy* users ) # r e I *l ast • • access 

* DELETING MEMBERS FROM THISLIB 

* NEW LIBRARY ON SESTMPL 

* NEW LIBRARY NOW ON THISLIB 

* SESTMPL PURGED 

* END WIPEMEM THISLIB 

This example of WIPEMEM illustrates the way In which multiple 
lists of record types may be coded* and also shows a range of record 
types coded for the rel type. 
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WIPULIB is a special version of WIPEMEM for deleting (wiping) 
member (s) from a User LIBrary. LIBEDIT (the basis for these library 
management procedures) can't handle user libraries directly* so 
WIPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctly. Parameters to WIPULIB are s 



I or b 



(optional) name of Library from which member (s) are to be 
deleted* If you don't code the I parameter* WIPULIB uses 
the value of profile variable lib as the name of the 
library. If there's no such profile variable defined* 
WIPULIB uses the name lib as the name of the library. 



til or nb ? 

(optional) name of New Library to be created at the end of 
the WIPULIB run. If you don't code the nl parameter* 
WIPULIB uses the value of profile variable newllb as the 
name of the new library. If there* s no such profile 
variable defined* WIPULIB places the new library back over 
the old library specified by the I parameter. 



un 



(optional) User Name in whose catalog the library 
specified by l/nl is to be found* if l/nl Is not in the 
catalog of the current user. If you don't code the un 
parameter* WIPULIB uses the value of profile variable 
libown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
WIPULIB uses the current user's catalog. 



iiem or m or rel : 

list of member(s) to be deleted 



lock or nolock : 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking Is the dfiLtauii 
action when the base being updated is in another user's 
catalog. If you don't code either of the lock or nolock 
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ISSiSf interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and noiock parameters* If 
you don f t code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there f s no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file ms.£ be in the same catalog as the base 
being updated* If the inter lock' fi le cannot be found* the 
procedure aborts* 

batch job parameters s 

These parameters are described In section 1*7 - M SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but it can be run in 
batch mode* The dayfile parameter is not used by this 
procedure* 



nx 



this (optional) &&x indicates that when WIPULIB performs 
the LIBGEN portion of its job* that LIBGEN should not 
build a cross reference of entry points in the ULIB 
record* You can set your own default for this parameter 
by defining the nx variable in your profile (any non-null 
value causes the cross reference to qo.£ be built)* Refer 
to the LIBGEN documentation in the NOS reference manual* 



msg or nomsg s 

these (optional) &&Y.S control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES*. 
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LIBEDIT is intended as a means of calling NOS LIBEDIT utility 
directly. Although SES library management procedures use the 
LIBEDIT utility themselves* not all the functions of LIBEDIT are 
available* since SES procedures are oriented towards the most common 
functions. The LIBEDIT procedure gives you direct control over the 
LIBEDIT utility* but still provides alt SES convenience of ATTACHing 
your files for you and so on* Parameters to LIBEDIT are : 

g or group or Igo * 

(optional) name of file containing record(s) to be 
inserted or replaced on the library specified by I* If 
you don't code the g parameter* LIBEDIT uses the value of 
profile variable group* and if there's no such variable 
defined* uses the default filename group* 



I or b 



(optional) name of the old Library to be manipulated by 
LIBEDIT* If you don't code the I parameter* LIBEDIT uses 
the value of profile variable lib as the name of the 
library* and if there's no such variable defined* LIBEDIT 
uses the default name of Mb* 



nl or nb s 

(optional) name of the New Library after the LIBEDIT run* 
If you don't code the nl parameter* LIBEDIT uses the value 
of profile variable newlib* and if there's no such 
variable defined* the LIBEDIT writes the new library back 
on top of the library specified by I* 



un 



i : 



(optional) User Name in whose catalog the library 
specified by l/nl Is to be found* If l/nl is not in the 
catalog of the current user* If you don*t code the un 
parameter* LIBEDIT uses the value of profile variable 
libown as the user name from whose catalog the library is 
to be obtained* and if there's no such variable defined* 
LIBEDIT uses the current user's catalog* 



(optional) list of character strings which represent 
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LI8EDIT utility directives* Using the i parameter* it is 
possible to perform many LIBEDIT operations using a single 

control statement. If you don't code the i parameter* 

LI8EDIT assumes the directives are coming from file 

INPUT* If you code the i parameter as a single name* 

LIBEDIT assumes that it's the name of a file containing 

LIBEDIT directives* 



this (optional) parameter specifies the name of the file 
to receive the listing output from LIBEDIT, If you don't 
code this parameter* LIBEDIT Places its listing output on 
fi le OUTPUT. 



lock or nolock 5 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file* Interlocking is the le.iauj.jt 
action when the base being updated is in another user's 
catalog* If you don't code either of the lock or nolock 
&&X&* interlocking Is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename? if there's no such profile variable* 
the name intrlok is used as the lock filename* The 
interlock file fflysi he in the same catalog as the base 
being updated* If the interlock file cannot be found* the 
procedure aborts* 



msg or nomsg : 

these (optional) fefixs control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Example of LIBEDIT Usage 

ses.libedlt l a prog!ib i* , *i»ovl /ca tal og» cat I i$t»sesmsg* 

* • • • • 

•*••• here appears the output from LIBEDIT utility 

* NEW LIBRARY ON SESTNPL 

* NEW LIBRARY NOW ON PR06LIB 

* SESTNPL PURGED 

* END LIBEDIT PROGLIB 

The example illustrates ho* the LIBEDIT utility input directive 

may be coded as a string parameter on the procedure call line* The 

text preceded by periods indicates where* In the actual use of 

LIBEDIT* output from the LIBEDIT utility itself appears. 
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6.0 S£IIIMS-.Ii£0£MIIQ!i 



This chapter describes a collection of SES procedures to find out 
what's going on and what's available* There are two main areas of 
Interest J 

1* Information about your local environment on NOS - what files 
you have* your validation limits* the time* parts of your 
dayfile* and others* 

2* Information about SES - documents* procedures and status* 

CATLIST display comprehensive information about files in a user's 
catal og. 

CATALOG gives a condensed list of the records in a library* 

PERMIT gives permission information for files in a user's 
catal og* 

FILES display information about local files* 

TOOLDQC prints documents describing tools 

TOOLREP displays status and problems for a specified tool or 
product* 

INFO displays the latest information about SES* 

USSDOC gets User Supplied Software document* * 

USSINFO displays the latest information about User Supplied 5 
Software. ! 
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DAYFILE displays a selected part of your dayfile* 

LIMITS displays your LIHITS Information in a condensed format* 

DISPLAY displays various information about your job environment 

TIME "talks** the current time as a dayfile message* 

DAYWEEK tells you what day of the week a date fell on* falls on 
(that is* today)* or will fall on* 

SESPRQC generates a list of names of SES procedures* 

SESPARM generates a printout of the parameter lists of SES 
procedures in any selected procedure library* 
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6,1 CATLIST - DISPLAY PERMANENT FILE INFORMATION 



6 . 1 £UU£l™DU£LM_££E£lAa£MI-£IL£-IM£Qatl&IIQM 

CATLIST gives you a concise but very comprehensive list of 
information about all files in a catalog* The files are listed in 
alphabetical order* three files per linet so that you can get 45 
files worth of information on one screenload* The world goes by 
your window more slowly* so to speak* For each file in the 
specified catalog* CATLIST outputs the information in the following 
format J 

FILENAM type category mode length 
where the different things displayed are s 

FILENAM is of course the name of file in question* 

type is the access type for the file* It is I for an Indirect 
file* and D for a Direct file* 

category is the security of the file* This field is PU for a PUblic 
file* SP for a Semi Private filet and PR for a PRivate 
fi ie. 

mode is the access mode for the file. This is one of R for 
Read* W for Write* M for Modify* A for Append* RM for Read 
Modify* and RA for Read Append and E for Execute* 

length is the length of the file in PRUS. 

For example* a typical line of output from CATLIST would be 
I ike : 

MAILBOX I PU RA ..1 MAXBIN D PU R 342 PROFILE I PR R ••! 

This line of CATLIST output shows that MAILBOX is an Indirect 

access £Ublic Read Append mode file of 1 pru* MAXBIN is a Direct 

access EUblic £«ad mode file of 342 prus* and PROFILE is an Indirect 
access ££ivate gead mode file of 1 pru* 
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6.1 CATLIST - DISPLAY PERMANENT FIIE INFORMATION 



Parameters to CATLIST are s 



un : 



pn 



o i 



(optional) User Name of the (alternate) catalog to be 
CATLISTed* If you don't code the un parameter* the 
current user's catalog Is CATLISTed» 



(optional) Pack Name for files to be CATLISTed* If you 
don't code the pn parameter* the files on the default pack 
are CATLISTed* 



(optional) name of file to receive the Output from 
CATLIST* If you don't code the o parameter* CATLIST uses 
file output* 

fpl : 

this (optional) parameter is used to teil CATLIST how many 
file descriptions it should write on each line of the 
output file* If specified* the Files Per Line parameter 
must be given a numeric value from 1 to 10* If you don't 
code the fpl parameter* CATLIST generates 3 files per 
I ine* 

Mate. J CATLIST can only handle the first thousand files in a 
user's catalog* 



Example of CATLIST Usage 
The example below shows a CATLIST for another user's catalog* 

ses.catllst un*ls69 

CATLIST OF LS69 FOR LR78 ( 13 FILES* 10769 PRUS I 
CSIOLIB SP R .167 CSIOPL. SP R .585 DICTION I SP R .125 
DOCBASE D SP R 1158 D01PL64 D SP R ..55 DG2R64. D SP R .347 
D02S64. D SP R .783 INTRLOK D PU R ...0 ISULLI8 I SP R ..37 
HAILBOX I SP M ...6 PR0CLI8 D SP R .409 PROGLIB D SP R 6126 
UTILITY D SP R .971 

* END CATLIST 

COMPANY PRIVATE 



6-5 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 171 User's Handbook REV? AB 

6.0 GETTING INFORMATION 

DAYFItE displays either the last 14 lines of your dayfile* or to 
display any number of lines starting at a specified character 
string* Parameters to OAYFILE are s 

n or 1 1st « 

(optional) number of lines of dayfile to display* If you 
don f t code the n parameter* DAYFILE displays 14 lines* 

find : 

{optional) character string at which to start displaying 
the dayfile* If you don»t code the find parameter* 
OAYFILE always goes to the line specified by last_line-n* 
If you code a character string for this parameter* DAYFILE 
goes to the last occurrence of that character string* then 
displays n lines starting from that string* 

o or output * 

(optional) name of file to receive the output from 
DAYFILE* If you don f t code the o parameter* DAYFILE uses 
file output* 

tifltfi s If you code the find parameter* the ? character may not be 
a part of the character string* as ? is used as the string 
delimiter for the search* 
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6.0 GETTING INFORMATION 

6,3 CATALOG - SHOW LIST OF; RECORDS IN A FILE 



6 . 3 £mLO£-=-£aflM_Un-QE-EE£ORQS-I&L A-EILI 

CATALOG performs the NQS CATALOG operation on a file* The NOS 
CATALOG utility outputs a large amount of information about the 
records* most of which is never used* The SES CATALOG procedure 
outputs a condensed form of the information from CATALOG* showing 
only the record names and their types* CATALOG outputs its 
information in the form : 

RECNAHE TYPE RECNAWE TYPE RECNAME TYPE RECNAHE TYPE 

four record names and their types are displayed on one line* so that 
if you're using a (713) terminal* the names and types of sixty 
records can be displayed before the information goes off the top of 
the screen* The world goes by your window more slowly* so to 
speak* Parameters to CATALOG are s 

I or b s 

name of Library or Base whose contents are to be 
CATALOGED. CATALOG is so arranged that if the file to be 
CATALOGed is local to your running job at the time the 
CATALOG runs* the file isn't RETORNed* If the file is not 
local when CATALOG runs. CATALOG GETs or ATTACHes the file 
for you* and RETURNS it when It has been CATALOGed. 



un 



(optional) User Name in whose catalog the file is to be 
found* if the file is not in the catalog of the current 
user • 



o or output J 

(optional) name of file to receive the Output from 
CATALOG. If you don't code the o parameter* CATALOG uses 
file output* 



short or long s 

these (optional) &e.y.s determine the format of the output 
from CATALOG* If you omit this parameter or code the 
short &£¥.* CATALOG produces its output in the form shown 
in the example below* If you code the long &£¥* CATALOG 
produces its output in the same format as the NOS utility 
CATALOG. 
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6.0 GETTING INFORMATION 

6.3 CATALOG - SHOW LIST OF RECORDS IN A FILE 



See also the descriptions of procedures CATBASE and CATLIB which 
provide useful defaulting of the I and un parameters* 



Example of CATALOG Usage 

This example shows a CATALOG operation performed on a library 
from another user's catalog* The CATALOG procedure obtains the 
library* and returns it when it has finished* 



ses.catalog afile# un*jf73 



CCEFMGR..QPLC 
CRACK. ...OPL 
EPBLD....QPL 
POUTESC.OPL 
SFWTIL...OPL 
AFILE....OPLD 
* END CATALOG 



CEDH.....0PL 
EDBLD....0PL 
FNTN5G...QPL 
PUSHERR..OPL 
SRCHHSG..OPL 

AFILE 



CEDTEXT..OPL 
EFHGR....QPL 
HSGDICT..OPL 
REPERR...OPL 
STRTUP...OPL 



CI0INT...0PL 
ENVINIT..QPL 
PINESC...OPL 
SFSKEOL..OPL 
TCS..*..*0PL 
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6,0 GETTING INFORMATION 

6.4 FILES - DISPLAY LOCAL FILE INFORMATION 



6 . 4 EILK-r.mEUI-LQCAL.EILE-IIIEQ&fi AIIQM 

FILES gives you a concise list of information about your local 
files. The output of FILES is a compressed form of the output from 
the NOS utility ENQUIRED. Parameters to FILES are i 

o or output s 

(optional) specifies the name of the file to receive the 

local file information. If you don«t code this parameter* 

FILES uses file output. 



all 



if you code this (optional) j££i» FILES includes in its 
output some files that are normally not included because 
they are always present (e.g. INPUT** INPUT* and 
OUTPUT). 



Example of FILES Usage 

ses.fi les 

IBSRC70 ..817 PH. UTILSRC .1447 PM* SCLEDIT ....3 LO. 

GROUP.. ...12 LO. 
* END FILES 

The example sho*s FILES being used to list local file information 
to the terminal. 
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6.0 GETTING INFORMATION 

6.5 PERMIT - OBTAIN FULL LIST OF PERMISSION INFORMATION 



6 . 5 ££ESII.-.aaiAIM«£y LL.LISI-Q£.££afiIiSiaii-IM£QEi!4IlQti 



PERMIT provides you with a permission information for all files 

in your catalog* or for a selected list of files* whereas if you use 

the NQS CATLIST utility* you can only list permissions one file at a 
time. Parameters to PERMIT are 5 



o or output t 

(optional) name of file to receive the Output from 
PERMIT* If you don f t code the o parameter* PERMIT uses 
f i I e output* 



f or fn J 

(optional) list of File Names for which you wish the 
permission information to be produced* If you don't code 
the f parameter* PERMIT gives the information for all 
files in your catalog* 



Example of PERMIT Usage 



ses.permit fn*proclib 

CATALOG OF WRB 
PROCLIB 



FM/CLSH176 80/10/28. 08*56. 42. 



1. SES READ 

2. SESAUX READ 

3. SLE READ 

4. EFT READ 



3 80/10/17. 09.43.18. 

1 80/10/28. 08.44.33. 

1 80/10/28. 08.50.29. 

1 80/10/28. 08.54.58. 



This example illustrates a typical use of PERMIT* The output 
from the PERMIT procedure is as that of the standard NOS CATLIST 
utility* 
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6,0 GETTING INFORMATION 

6.6 LIMITS - DISPLAY VALIDATION LIMITS 



6 . 6 uaiis.=.ais£ux JULiaAiia».Liam 

LIMITS provides you with a condensed version of the display that 
you'd get by using the NOS LIMITS control statement* The LIMITS 
control statement uses 35 lines to display the information* By 
using this LIMITS procedure* you get that information in five lines* 
thereby conserving space* Parameters to LIMITS are i 

o or output : 

(optional) name of file to receive the Output from 

LIMITS* If you don f t code the o parameter* LIMITS places 

the display on file OUTPUT. 



Note that this LIMITS procedure formats the LIMITS data such that 
the word UNLIMITED Is represented by an asterisk C*)* 



Example of LIMITS Usage 

This example shows the use of the LIMITS procedure* and the 
typical output generated by it* 

ses* I i mi ts 

UI-612 AB*» AB** AB*» AB** HT*** RP*** TL*** CM**, NF*** 
DB**# FC*** CS*** FS*** PA*EVEN* R0*SYSTEM* PX*HALF* TT*TTY* 
TC*ASCII* IS*BATCH» MS*** DF*** CC*** OF*** CP*** LP*** 
EC*** SL*** CN** PN** DS**» AW*00007777777700007557 
* END LIMITS 
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6.0 GETTING INFORMATION 

6,7 TIME - DISPLAY CURRENT TIME OF DAY 



6.7 IlllE-=-ttlS£LAr-£UR&EMI-II!!£.flE.fiAI 

TIME is a quick way of finding the time <to tNe nearest five 
minutes). The SES TIME procedure "talks" the time as a dayfile 
atessage* for example s 

ses* time 

* TWENTY FIVE PAST TWELVE 
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6 . 8 QIi£LAt-=.aiS£LAI-5tAEIflUS-USE£UL-IliEDaillAIIflli 

DISPLAY provides you with an easy way to ask for the display of 
odd things such as the job control registers* field length* 
switches* date* time and so on. You can request the display of many 
things at a time. The display is formatted in a "dense" fashion* to 
minimize the number of lines of screen used* There are only two 
parameters to DISPLAY that require values* the rest are just jiaxs. to 
indicate what you want displayed* The two parameters zre the expr 
or e parameter* described below* and the o parameter which 
determines which file the display goes to* The display goes to file 
ouput by default* JsfiZS that indicate to DISPLAY what you want to 
know. You use DISPLAY like this : 

ses.display tMngl* thingZ* thing3* etc. 

where the "things" are any or all of the keys described here* 

k&y. Bufltls-disaiastfid 

expr or e displays the value of any valid SES expression. A list 
of the arithmetic operators available for expressions is 
given in the description of the HATH procedure below* A 
full description of the syntax of expressions can be 
found in the SES Procedure WriteMs Guide* 

date displays the current date in the form : AUG 1* 1978 

time "talks" the time in the form i TWENTY FIVE TO ELEVEN. 
The time given in this form is always rounded to the 
nearest five minutes. 

clock displays the clock time in the form s 4*23 PN 

fl displays your current Field Length 

rl displays the contents of job control register Rl 
rZ displays the contents of job control register R2 

r3 displays the contents of job control register R3 

ef displays the contents of the Error Flag 

jcr displays the contents of all four Job Control Registers* 
Rlt R2, R3 and EF* 

sw displays the six sense Switches 1 to 6 in left to right 
order • 
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alt displays ALL the above information 



Example of DISPLAY Usage 



ses. display all 
Ft * *5000<8)» Rl « *500» 1062*18), R2 « 
R3 * 6789, 1520518), EF » 0* SW » <F,T,F,T,T, F) 
JAN 25* 1980, TWENTY PAST FOUR 

* END DISPLAY 
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6*0 GETTING INFORMATION 

6.9 OAYWEEK - DISPLAY DAY OF THE WEEK 



6 • 9 Mm£H-::-aimAX-JUX-QE-I8L-aE£& 

OAYWEEK is used to determine what day of the week any date 
(including today) fell on» is» or will fall on. Parameters to 
OAYWEEK are : 



day : 

(optional) specifies the number of the day in the month. 
If you don f t code this parameter* the current day of the 
month is used* 



month i 

(optional) specifies the month either as a number (1..12) 
or as a string (of which the first 3 characters are 
used). If you don f t code this parameter* the current 
month is used. 



year s 

(optional) specifies the year. Note that all the digits 
of the year must be given* If you don*t code this 
parameter* the current year is used. 

o or output : 

(optional) specifies the name of the file to receive the 
output from OAYWEEK. If you don't code this parameter* 
DAYWEEK writes its output to file output. 
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6.0 GETTING INFORMATION 

6,10 TOQLDOC - PRINT TOOL DOCUMENT 



6,10 IQaLQQC-r-EaiMI-IQQL-QQaUBEai 

TQOLDOC is the means by which on-line and/or off-line copies of 
TOOL DOCuments are made available* Parameters to TOOLDQC are * 



docs or d : 

This (optional) parameter is used to indicate which 
document(s) you wish to obtain* Document names are taken 

from the "document number" column of the document index 

display (see the 'doclist* parameter)* The absence of this 

parameter will default the proc to display the entire 
document index* 

docl 1st or dl s 

(optional) used to indicate that the document index is to 

be displayed - or retained on a file named by the Misting' 

parameter* The 'doclist* parameter is ignored if the 

•docs* parameter is specified* Specific portions of the 

document Index are displayed by using the following keys 

with this parameter: 

CY3IL - CY8IL Compiler related documents* 

C170 - SES Development and Support tools other than those 

for C180 Project. 
C180 - C180 Operating System development documents* 
OTHER - Documents that don't fit into the categories 

above* 
SITE - Documents available only at the local user's site* 
ALL - All of the above categories* This is the default 

if none of the above keys are indicated* 

listing or I : 

(optional) name of file to receive the d&fiUOfiat iOiifiS. 
display. (when using TOQLDOC without specifying any 
document (s ) )> gc the formatted document(s) themselves* If 
you code the listing parameter to direct the document(s) or 
the document index to a file* that file is not printed* 



bin 



(optional) fiiltl number used at Sunnyvale Development 
Division to indicate the bin number the output is to go 
to. If you don't code the bin parameter* TQOLDOC uses the 
value of profile variable userbin* and if there's no such 
variable defined* generates a bin number of NO-ID. 
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6.0 GETTING INFORMATION 

6.10 TOQLDOC - PRINT TOOL DOCUMENT 



Note that the standard SES batch job parameters are available, 
The default Is to run the job In batch mode* 



Example of TOQLDOC Usage 

ses.tooldoc arh2739 

10.36.10. SUBMIT COMPLETE. J08NAHE IS AAEQAXA 

* 4QB TOQLDOC SUBMITTED 

This example would cause the ERS for CY8II I/O to be printed on 
the system line printer. 

ses.tooldoc !*doc!ist 

* INDEX DISPLAY -> DOCLIST 

* T00LD0C DISPLAY COMPLETED 

This example copies the document index to the file DOCLIST. 
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6.11 TOOLREP - LIST TOOL REPORT 



6.ii iaaL&££«z.Lisi-iaaL.R££Qai 

TOOLREP provides a display of the current status and/or 
outstanding problems for a specified tool or product. Parameters to 
TOOLREP are t 

tool or t s 

specifies for which tool or product a report Is desired. 
Currently* the &nLx supported values for the tool parameter 
are SIH180 (the CYBER 180 Hardware System Simulator), CYBIL 
(CYBIL compilers), and SCU (Source Code Utility). 

status or problms * 

if one of these (optional) j£e.y.s is coded, only that portion 
of the report (status or outstanding problems) is 
displayed. If you don't code either of the fc£Y.£, both 
portions of the report are displayed. 



o i 



(optional) name of file to receive the Output from 
TOOLREP. If you don»t code the o parameter, the output 
goes to file OUTPUT by default. 



Examples of TOOLREP Usage 

ses.toolrep slml80 status 

This example of TOOLREP displays the current status of the CYBER 
180 Hardware System Simulator. 

ses.toolrep scu 

This example of TOOLREP displays the current status of the NQS 
170 version of the Source Code Utility and known problems with the 
util ity. 
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6.12 INFO - ACCESS SES INFORMATION 



6.12 IMEQ-r-ACCESS-SES JLtiEa&MAIIQia 

INFO is a means whereby users pay get up to the minute bulletins 
on changes in SES. Parameters to INFO are J 



o or output * 

(optional) name of file to receive the Output from INFO. 
If you don't code the o parameter* INFO outputs the INFO 
file to OUTPUT. 



II : 



if you code this (optional) &£*♦ INFO gives you ALl the 
information from the INFO file. If you don*t code the all 
!£££> INFO only gives you the last record of information 
from the INFO fi le. 
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6.13 y|SOOC^-^GE J„US|R_SUPPL I EQ^ l^tDitit^^tll^l^^ „„„„„„„„ 

USSDOC is the means by which on-line copies of User Supplied J 
Software documents are wade available* Parameters are ? J 

product or pr * 

This (optional) parameter is used to indicate which 
document you wish to obtain* Document names are the same 
as the product itself* The absence of this parameter will 
default the proc to display a catbase listing of what is 
available on the document file* 

listing or I ? 

(optional) name of file to receive the document you wish to 

retrieve* If you don*t conde ths I parameter* the output 

appears on file LISTING* 

Example of USSDOC Usage 

SES.USSDQC PR-GET L»LISTOUT 

* END USSDOC GET -> LISTOUT 

This example retrieves documentation on GET to the file LISTOUT* 
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6,14 USSINFO - ACCESS USS INFORMATION 



6.14 ym&EQ™AC££SS-U$S-Il!l£QRiS MIOB 

USSINFO is a means whereby users may get up to the minute 
bulletins on changes in User Supplied Software. P arameter C s) to 
USSINFO are s 



o or output i ' 

(optional) nape of file to receive the output from * 

USSINFO. If you don*t code the o parameter* USSINFO ? 

outputs the USSINFO file to OUTPUT. S 
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6.15 SESPROC - LIST SES PROCEDURE NAMES 



6.15 SEiE&a£.= J.iai-£££-E£Q££QU£E..!!iM££ 



SESPRQC displays a list of procedure names already used by SES. 

This Is of use if you are a procedure writer and wish to create new 

procedures for use in SES. You can then use SESPROC to ensure that 
there Isn't any naie conflict. Parameters to SESPROC are : 



un : 



(optional) list of user names whose catalogs are to be 
searched for procedure libraries. SES uses the SES 
Library NAMe as the name of the procedure library to look 
for. If you don't code the un parameter* SESPROC displays 
the names of procedures in the PR0CLI8 of the current 
user* and the names of procedures on SES library. 



o or output * 

(optional) name 
SESPROC. If you 
file output. 



of file to receive the Output from 
don't code the o parameter* SESPROC uses 



Example of SESPROC Usage 



ses.sesproc un«ed73 
UN » E073 

CETGEN 

ICGEN MOVDOC 

RELSUB REPOOC 

* END SESPROC 



COLLDOC C0LLSU8 EOTDOC EDTMOO EOTSUB 
MOVSUB PERT PRTDOC PRTSUB RELDOC 
REPSUB SENOKC MIPEOQC WIPESUB 



This example shows SESPROC used to determine the names of SeII 
procedures in the PRQCLIB of user ed73. ' ,vj 
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6. 16 SES£A&a-=.£RIIiI-£A&Att£IEE-REaUI&£HEMIS-£Qa-S£S-£ROCS 

SESPARM prints out the parameter definitions for all the 
procedures on a library* It runs batch or local with batch as the 
default* Parameters to SESPARM are : 



I : 



un 



name of Library whose parameters are to be printed. 



(optional) User Name where the library is to be found* If 
you don f t code the un parameter* SESPARM assumes that the 
library is in the catalog of the current user* 

o or output or listing s 

(optional) name of file to receive the Output of SESPARM* 
If you don't code the o parameter* the output appears on 
file LISTING, 

batch job parameters s 

These parameters are described in section 1*7 - **S£S 
PROCEDURES RUN AS BATCH JOBS*. The default for this 
procedure is to run in batchn mode* but it can be run in 
local mode* The dayfile parameter is not used by this 
procedure* 

print : 

(optional) parameter to control the PRINTing of the 
output* When the job runs in batch* one copy is printd 
automatically* If you run the procedure in local mode* no 
copies are printed* unless you specifically code some 
print parameter* For example* you could code print*c»3 to 
obtain three copies of the parameter listing* The format 
of the print parameter is that of the parameters for the 
PRINT procedure* 

tifltfi that the parameter list of each procedure ms£ terminate 

with a PARMENO directive* or* for those records In a library which 

don't have a PARMENO directive by virtue of the fact that they're 

INCLUDE files* the parameter list must be terminated by a 
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6.16 SESPARH - PRINT PARAMETER REQUIREMENTS FOR SES PROCS 



PARHEND " 









Example of ! 


SESPARH Usage 




es.sesparro 

ncftiic 


l«proclib un*hk77 local noorint 




UtOuo 

\ PARK 




KEY 


a • f • 


NVALS * I..NAXVALS 


NAH 


V PARH 




KEY 


■ f f args t » 'a'} 


NVALS * 1 


STR 


\ PARH 




KEY 


m % p • 


NVALS * 1..MAXVALS 


NAH 


\ PARH 




KEY 


• • | i 


NVALS « 1 


NAH 


\ PARH 




KEY 


» *e» 


NVALS * I..HAXVALS 


STR 


\ PARH 




KEY 


* «xld* 


NVALS « 1..HAXVALS 


STR 


\ PARHEND 










satasBSXsxx 










DBUGFTN 












\ PARH 


KEY * 


<M*» «f») NVALS 


* 1 NAH 




\ PARH 


KEY « 


•I* NVALS 


« 1 STR 




\ PARH 


KEY « 


*b« NVALS 


» 1 STR 




\ PARH 


KEY * 


Mo 1 NVALS 


» 1 NAH 




\ PARHENO 











* END SESPARH PR0CLIB/HK77 -> OUTPUT 

Although this is a rather contrived example of a procedure 
library with only two procedures in it# it illustrates the output 
that SESPARH generates* SESPARH Is run In local mode* or while you 
wait* to produce the parameter definitions for procedures in library 
proclib in the catalog of user hk77. The noprint fcay. inhibits 
printing of the generated output. 



The diagram on the next page shows the alternative forms of 
parameter definitions of SES procedures. Alternative forms are 
arranged in the vertical columns. The blocks of text below provide 
a brief description of each field of a parameter definition. 
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6.16 SESPARN - PRINT PARAMETER REQUIREMENTS FOR SES PROCS 



\ PARM KEY * (»K1*# •K2»#...«KI»> NVAtS 

keyword 
\__„ / \„ / \ 



This command starts 
the definition of an 
SES PARaHeter. 



KEY specifies the key- 
word or keywords that 
may be used when coding 
a parameter for an SES 
procedure. 



NAN 
NUM 
min..max STR REQ RNG 

number FGN 
J \J \_/ \_/ 



NVAtS sp 
that may 
form win 
of *«in w 
values ma 
is specif 
max are 
value of 
that the 
that the 
option k 
indicates 
as an o 
values. 



eclfies th 
be coded fo 
••max indi 
values* and 
y be coded, 
iedt It mea 
the same. 
zero CO)* 
re may be 
parameter k 
ey. NVALS 
that the k 
ption* or 



e Number 


of VALues 


r a paramet 


er. 


The 


cates that 


a minimum 


a maximum 


of "max" 


If only one number 


ns that the 


\ mln 


and 


If NVALS specifi 


ies a 


then it 


1 ndicates 


no values coded* and 


eyword is used as an 


specified 


as C.max 


eyword may 


be 


used 


that It ma) 


t be given 



This field indicates the parameter type. It may 
be NAMe» NUHber* STRing* or ForeiGN text. Refer 
to the INTRODUCTION section for a description of 
parameter types. 



< ♦ 



If this field is coded 
description* it indicates 
REQulred* and therefore may 



in the parameter 
that that parameter is 
not be omitted. 



If this field is coded in 
description* then it indicates 
value(s) may be coded as a RaNGe* 
form first..last 



the parameter 

that parameter 

that is* In the 



— ♦ 
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7.0 FILESPACE MANAGEMENT 



7.0 EILEXEAtE-ttAUAfiEaEBI 



SES provides some useful utilities to aid you in handling your 
files* The procedures described here are : 

RETAIN GETs or ATTACHes all your files to stop then? being 
archi ved. 



DUMPPF 

LQADPF interfaces to the Minnesota Dump and Load utility to 
provide easy to use dumping and loading of files. 

REWRITE provides a "safe" way to rewrite a file after it has been 
modi f i ed» 
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RETAIN GETs or ATTACHes ail your files to ensure that they aren't 
archived* RETAIN also provides the facility to CATALOG either 
designated files* or all DIRECT access files in your catalog* 
Parameters to RETAIN are : 



batch Job parameters * 

These parameters are described in section 1.7 - H SES 

PROCEDURES RUN AS 3ATCH JOBS". RETAIN runs in batchn mode 

by default* RETAIN doesn't use the dayfile parameter. 

c or noprint : 

(optional) coding c alone as a &£g causes all DIRECT 
access files in the catalog to be CATALOGed. Coding a 
list of files for c causes only those specified files to 
be CATALOGed. Coding the noprint &£y. suppresses all 
output from RETAIN. 



s or short * 

coding the (optional) short fc£* directs RETAIN to generate 
a short SES style CATLIST output instead of the NOS long 
form CATLIST. RETAIN generates the NOS style long form 
CATLIST by default. 
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DUMPPF and LOADPF Interface to the DUMPPF and, LOADPF system 
utilities (the so called Minnesota Dumpers) They 1 provide a 
reasonably easy to use means of dumping files to magnetic tape and 
retrieving them when required* Your only problem is? whether you 
want to trust tapes* Parameters for DUMPPF and LOADPF are almost 
the same* so they are described together* with variations explained 
as required* Parameters are 5 

f He or f i les s f 

(optional) list of files to be processed* If you don't 
give any file names* all files (or files determined by 
other selection criteria) are dumped* 

tape or vsn s 

(optional) number of the tape to be used for the dump or 

load* tape is intended for 'standard* library tape 

numbers* If you have tapes with visual labels such as 

A8C023 (a typical CANCDD number) or a U or T tape (SDD User 
or Temporary tape)* you use the special parameter described 
I ater * 



pn or pack or packnam : 

(optional) name of user pack on which the files are to be 
processed* If you don't specify a pack name* files are 
accessed from the family* 
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7*0 FILESPACE MANAGEMENT 

7*2 DUMPPF / LOADPF - DUMP / LOAD PERMANENT FILES 



The next six parameters are the options for a tape REQUEST 
command* They all have defaults and they can all be specified via 
PROFILE variables* The parameters are described in the table below 
for easier reference* 



* Eataiatac • X ££flfil£ X 

i &£y.ao.f.o: \ Q&fault x yatiafcla X EiLaafitsi: Usase 


• seven or at * \ X 

X nine or nt I NT • tapetrk \ indicates whether to 
1 XXX use se^/ert or nine 
X XX X track tape* The 

* XXX default is to use 
S XXX nine tracks (NT)* 


X d or density X PE or HD * tapeden 5 tape density to be 

* XXX used* The letters 

* ! ! 5 you use to indicate 
! XXX this have to be 
? * * * different depending 
J X X X on whether it's seven 

* ! * * or nine track* 


! f or format J I ! tapefmt X tape format to use* 
* ' ! 1 The default is I* 
X XXX that is* NQS 
! J • 'Internal* 


X lb or label X KL J tapelab X tape U&EL 
X XXX specification* The 
! XXX default is KL* that 
X XXX is* &RGN0S LABELLED* 


X po or options X R (load) * * 

X X W (dump) X tapeopt * processing Options to 
' 1 * ! be used* The 
! ! ! ! defaults are P0»R for 
! X X X a LOADPF and P0»W for 
X X X X a DUMPPF. 


* special I no default 5 special « indicates special 

! * * * tape names or numbers 
5 * * * as mentioned above in 

* ! ! J the description of 

* XXX the tape parameter* 
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catalog or itemize * 

coding one of these (optional) &e.¥5. causes the CATALOG or 
ITEMIZE utility to process the tape to give a list of 
records on the dump* If these options are selected* the 
tape is rewound before and after the operation* 

The next five parameters control the DUMP/LOAD process* The most 
used things are supplied by specific keyword* and the xp parameter 
is used as a catch all for anything else you might want to do* 

ty or type s 

(optional) IY.EE of files to process* If you don't code the 
type parameter* TY*ALL is used* Other options are TY»I (to 
process only Indirect files) or TY«D (to process only 
Qirect files)* The DUMPPF/IOADPF procedure doesn't check 
the validity of any options you code here* 



lo 



this (optional) &e.v. directs DUMPPF/LOADPF to process LOCAL 
files only* Normally* permanent files are processed* 



na or noabort : 

this (optional) Jsay. directs DUMPPF/LOADPF to BQt iaQRI if 
any errors are encountered during processing* The normal 
default is to abort* 

np or nopurge s 

this (optional) j£gy. is only applicable to LQADPF* and it 
directs LOAOPF to 8Qt SJJ&SE already existing files when 
loading* This means that already existing permanent files 
are skipped on the load* The normal mode is that existing 
permanent files are purged before loading* 

XP 5 

(optional) e&tra £arameters for DUMPPF/LOADPF* You code 
this in the form of a character string* The examples at 
the end should clarify it* 

It or loctape : 

(optional) LQCa i IAEE name for the tape request* 
DUMPPF/LOADPF normally requests the tape as a unique name* 
If you are running DUMPPF/LOADPF as part of a larger job* 
and you want access to the tape outside the process* you 
can give your own name to the tape by coding the loctape 
parameter. 

batch job parameters * 

these parameters are described in section 1*7 - M SES 
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7.2 DUMPPF / LOAOPF - DUMP / LOAD PERMANENT FILES 



PROCEDURES RUN AS BATCH JQ8S W - of the SES USER'S 
Handbook. DUMPPF/LGADPF run in batch mode by default* 



Examples of DUMPPF / LOAOPF Usage 

ses.dumppf tape 666 
07.48.35* SUBMIT COMPLETE. JOBNAME IS AGRIBUS 

* JOB DUHPPF SUBMITTED 

This Is the simplest example of DUHPPF usage* your entire catalog 
is dumped to tape 666. The REQUEST statment that SES generates for 
the dump looks like this s 

$REQUESTCZQxxxxx,NT.D*PE.F»I,LB«KL. PO»W. VSN»000666> 

Note that DUMPPF / LQADPF fill in the leading zeros in the VSN in 
the tape request if they are required* Now for a slightly more 
complex example : 

ses.dumppf (wi I son*heath« ni xon» agnew) . spec i at*abcl23» ..... 
* • ? po*Mune» d*hy 
19. 17. 15, SUBMIT COMPLETE. JOBNAME IS ABXTCUB 

* JOB DUMPPF SUBMITTED 

In this example* the four files in the parenthesised list are 
dumped to tape A8C123. The tape processing Options (the po 
parameter) are set to WUNE* and the tape Density (the d parameter) 
is set to HY (800 bpi) instead of the default PE (1600 bpi)* 

ses.loadpf tape 789t nopurge* pack ftn# xp» •ct*spr i v 1 
16.42.55. SUBMIT COMPLETE. JOBNAME IS ADRQBIT 

* JOB LOAOPF SUBMITTED 

This example loads all your semi-private files (specified via the 
xp parameter In the example) onto the FTN pack (the pack 
parameter)* Note that the nopurge Jigy. is coded* so that already 
existing permanent files are skipped during the load of files from 
tape 000789. 
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7.3 g£MEII£.:.££MEII£.£IL£ 

REWRITE is mainly used as a building block for the source text 
maintenance and library management procedures* where rewriting of a 
base or library is required* REWRITE is a "safe" way of performing 
the overwrite process* If for some reason REWRITE fails to perform 
the rewrite* it tries five (5) times before It gives up* Parameters 
to REWRITE are s 

i or rewr i ti : 

name of Input file to REWRITE* 



o or rewrito : 

name of Output file after the REWRITE process is 
complete* This is the new file created by the rewrite* 



un or rewritu ? 

(ootional) User Name in whose catalog the file specified 
by o is to be found* if it isn't in the catalog of the 
current user* If you don't code the un parameter* REWRITE 
uses the user name of the current user* 



f ai led or rwf ai Id : 

(optional) label to which REWRITE is to GO TO in the event 
that the rewrite falls* If you don't code the failed 
parameter* In the event of a failure* REWRITE performs an 
EXIT. 



loopend or rwloopd : 

(optional) label to which REWRITE is to GO TO if the 
rewrite cannot be performed after five attempts* 



msg or nomsg : 

these (optional) &§.¥.£ control the generation of 
informative messages by this procedure and are fully 
described in section 1.6 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 

tlfttfi 5 If the new file (given by the o parameter) is an existing 
INDIRECT access filet it is REPtAGEd. If the new file is an 
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existing DIRECT access filet REWRITE performs an overwrite process 
bv ATTACHing the file In WRITE mode* If the new file doesn't exist* 
REWRITE DEFINES the new file as a DIRECT access READ mode file 
(this* of course? can only be done if the un parameter is omitted or 
Is given as the user name of the current user)* 
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8.0 £Ga£ILIH£i.-LX&mii£i.-&&Q-a£ay££ING 



This section describes the SES procedures available for compiling 
(assembling) programs written in various languages* and for linking 
relocatables into executable form* The procedures currently 
available in this category are s 

CYBIL run the CY8IL CC or CYBIL CI compiler* 

ISWL run the ISWL CC compiler. 

SYMPL run the SYMPL compiler. 

FTN run the ForTraN extended compiler* 

FTN5 run the ForTraN-5 compiler. 

COMPASS run the CPU/PPU ASSembler for the CYBER 170* 

CPAS180 run the CPu Assembler for the CYBER 180. 

PPAS180 run the PPu Assembler for the CYBER 180. 

LINK170 link relocatable binaries to form an absolute program. 

GETCCDB gets the CYBIL CC Interactive Debugger ready for use. 

GETLIB(S)get CYBIL run time library local to the job. 
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8.1 CXfiLL-=-&Ua-CXaiL-£C_QR-£mL-CI-£attEILE& 

CYBIL runs the compiler for the CDC CY8ER IMPLEMENTATION 
LANGUAGE. Two compilers are available: CC to generate code to be 
run on a CYBER 170 machine; and CI to generate code to be run on a 
CYBER 180 machine. 

The procedure is arranged so that if there are any eompile-time 
errors detected* the NQS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the compiler. 



Parameters to the CYBIL procedure are 



i or f 



(optional) name of Input File to be compiled* If you 
don»t code the i parameter* CYBIL assumes that the input 
is on a file called compile. 



(optional) name of file to receive the Listing from the 
compiler. If you don*t code the I parameter, the compiler 
output appears on a file called listing. This listing 
file is not rewound by the CYBIL procedure. 



(optional) name of file to receive the Binary object code 
generated by the compiler. If you don*t code the b 
parameter* the binaries appear on a file called Igo. This 
Igo file is not rewound by the CYBIL procedure. 

cc or ci : 

these (optional) issis determine which of the compilers is 
used. If you don't code either of these keys or if you 
code the cc key, the CYBIL CC compiler is used* If you 
code the ci key, the CYBIL CI compiler is used, liaifi s 
you can set your own default compiler selection in your 
profile be setting a variable called cybll to one of these 
keys* 

Hats 5 this parameter is used to select a version of the 
CC or CI compiler other than the standard one released via 
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8.1 CY8IL - RUN CYBIL CC OR CY8IL CI COMPILER 



the SES. This is done by coding as a value for this 
parameter the user nape of the owner of the compiler 
you're after. For example* entering cc*lp3 accesses the 
version of the CC compiler residing in the LP3 catalog. 
It is necessary for the owner of such a compiler to use 
the file name CYBILC for the CC version and CYBILI for the 
CI version in order to allow the compiler to be accessed 
via this procedure. 
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lo 



this (optional) Parameter specifies the Options to be used 
when producing the Listing* Any combination of the 
following designators may be coded for this parameter s 

a specifies that a map of the source input block 
structure and stack is to be produced 



specifies that a full listing is to be 
(selects list options S* A# and R) 



produced 



o specifies that the listing should include the generated 

object code in an assembler-like format 

s specifies that the listing of the source input file is 
to be produced 

w specifies that the listing of warning diagnostic 

messages is to be suppressed 

r specifies that a symbolic cross reference listing is to 

be produced 

ra specifies that a symbolic cross reference listing of 
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ail program entities is to be produced whether 
referenced or not 

x aorks in conjunction with the LISTEXT pragmat such that 
LISTings can be EXTernally controlled via the compiler 
cal I statement* 

If as. is specified* no listing is produced* If the lo 
parameter is omitted* a listing of the source input file 
only is produced* 



debug or d or nodebug s 

this {optional) parameter is used to select the debug 
options to be In effect for the compilation* The 
available debug options are s 

sd If this option is selected* the compiler includes 
Symbol Table information in the object code fife to 
be used by the CYBIL interactive debugger* If this 
option is not selected it isn»t possible to 
symbolically debug the module(s) being compiled* 

fd This option produces the same tables as d*sd plus 

stylizes the generated code to provide a step 

facility when using the symbolic debugger (it is only 

meaningful* currently* when used with the CC 
compi I er ) * 

ds If this option is selected the Debugging Statements 
appearing between ?? nocompile ?? and 
?? compile ?? praqmats is compiled* otherwise such 
statements are skipped by the compiler* 

If you omit this parameter or you code the nodebug Efiy.* 
none of the sd* fd or ds options are selected* If you 
code the debug or d &£¥.£ but don»t code any values* 
debug*sd is used* To select combined options you can code 
debug*! sd»ds) or debug*( f d*ds) . 



pad 



coding a numeric value for this (optional) pad parameter 

generates the specified number of no-ops between machine 

instructions* This feature is used for the P3 
di agnost i cs* 
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opt 



this (optional) parameter is used to select optimization 
levels in the (CI aall) generated code* Legitimate values 
are $ 

Provides for keeping constant values in registers. 

1 Provides for keeping local variables in registers. 

2 Eliminate redundant memory references* 



msg or nomsg : 

these (optional) &£¥§. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Example of CYBIL Usage 

ses.cybil lo» f or»» chk»*sn f 

* END CYBIL COMPILE -> LISTING* LGO 

This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE. A listing is produced consisting of 
the source input* generated object code* and a symbolic cross 
reference* on file LISTING. The object code is written to file LGO 
and will include run-time checking code for Subscript ranges and NIL 
pointer de-reference. 
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8.2 I&ML-=-RUii-ISML-££-Catt£IL£B 

ISWL runs the ISWL CC compiler. 

The procedure Is arranged so that If there are arty compi I e-t i me 
errors detected, the NOS 4ob Control Register called EF Is set to a 
non-zero value. This feature Is used when this procedure is being 
used as a building block, to determine what steps should be taken 
subsequent to running the compiler. 

Parameters to the ISWL procedure are s 

i or f : 

(optional) name of Input File to be compiled. If you 
dor**t code the i parameter, ISWL assumes that the input Is 
on a file called compile. 



(optional) name of file to receive the Listing from the 
compiler. If you don't code the I parameter, the compiler 
output appears on a file called listing. This listing 
file is not rewound by the ISWL procedure. 



(optional) name of file to receive the Binary object code 

generated by the compiler. If you don't code the b 

parameter, the binaries appear on a file called Igo. This 
Igo file Is not rewound by the ISWL procedure. 



io 



if this (optional) parameter is specified as £, a symbolic 
cross Reference map is produced on the file specified by 
the I parameter. (R is the only List Option available 
with this ISWL procedure.) If you don't code this 
parameter, ISWL does not produce a cross reference. 



small or medium or large : 

these (optional) fce.y.£ are used to select the size, of the 
ISWL compiler to be used. As you might have already 
guessed, three sizes are available. The default is medium 
but this can be over-ridden by defining in your profile a 
variable called iswlsiz set to one of these keys. The 
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compiler size determines how large a module can be 
comp i 1 ed* 



debug or nodebug : 

these (optional) fcsis select whether you want the compiler 
to generate (in the object code file! information for the 
ISWL DEBUGger which runs under the SES SUBSYStem* If you 
code the debug &££* ISWL generates the debug information* 
If you code the nodebug Js££ or if you don*t code either of 
these keys* ISWL does not generate the debug information* 



Rsg or nomsg : 

these (optional) !s£XS control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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This procedure runs the SYMPL compiler for the CYBER 170. 

The procedure is arranged so that if there are any compi I e-t I me 
errors detected* the NOS Job Control Register called EF is set to a 
non-zero value* This feature is used when this procedure is being 
used as a building block, to determine what steps should be taken 
subsequent to running the compiler* 

Parameters to the SYMPL procedure are s 

i or f J 

(optional) name of Input File to be compiled* If you 
don't code the i parameter* SYMPL assumes that the input 
is on a file called compile* 



(optional! name of file to receive the Listing from the 
compiler* If you don f t code the I parameter* the compiler 
output appears on a file called listing* This listing 
file is not rewound by the SYMPL procedure. 



(optional) name of file to receive the Binary object code 
generated by the compiler* If you don't code the b 
parameter* the binaries appear on a file called Igo* This 
Igo file is not rewound by the SYMPL procedure* 



to 



xp 



this (optional) parameter is used to specify the List 
Options for the compilation (see the SYMPL reference 
manual for legal list options)* If you don't code this 
parameter* SYMPL uses only list option L* 



this (optional) parameter is used to pass extra Parameters 
to the compiler (see the SYMPL reference manual for a list 
of allowed SYMPL control statement parameters)* If you 
want to pass extra parameters* the list of them must be 
specified as a string (within single quotes)* The SYMPL 
procedure does not check the validity of the parameters in 
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the string. If you don't code this parameter, no extra 
parameters are passed to the compiler* 



debug or nodebug s 

these (optional) k£lS select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug &£¥> SYMPL includes the 
debug information in the object code file. If you code 
the nodebug *££! or if you don't code either of these keys* 
SYMPL doesn't generate the debug information* 



msg or nomsg s 

these (optional) Jseis control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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8 ♦ 4 EI!l.-.aUli.ia£.EItl.l£Q&IRAl!l-£lI£tiQEfti.aatt£ILE8l 

This procedure runs the FTN (ForTraN extended) compiler for the 
CYBER 170. 

The procedure is arranged so that if there are any compi i e-ti me 
errors detected, the NQS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building block, to determine what steps should be taken 
subsequent to running the compiler. 

Parameters to the FTN procedure are s 

i or f s 

(optional) name of Input File to be compiled* If you 
don*t code the I parameter, FTN assumes that the input is 
on a file called compile. 



(optional) name of file to receive the Listing from the 
compiler. If you don't code the I parameter, the compiler 
output appears on a file called listing* This listing 
file is not rewound by the FTN procedure. 



(optional) name of file to receive the Binary object code 
generated by the compiler. If you don*t code the b 
parameter, the binaries appear on a file called Igo. This 
Igo file is not rewound by the FTN procedure. 



fl 



XP 



this (optional) parameter specifies the Field Length to be 
used while running the compiler. If you don't code this 
parameter, FTN uses a field length of 70000(8). 



this (optional) parameter Is used to pass extra Parameters 
to the compiler (see the FTN reference manual for a list 
of allowed FTN control statement parameters)* If you want 
to pass extra parameters, the list of them must be 
specified as a string (within single quotes). The FTN 
procedure does not check the validity of the parameters in 
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the string* If you don't code this parameter* no extra 
parameters are passed to the compiler* 



debug or nodebug s 

these (optional) fcs*s select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug jsei# FTN includes the debug 
information in the object code file. If you code the 
nodebug &e.v. or if you don f t code either of these keys* FTH 
doesn't generate the debug information. I 



msg or nomsg : 

these (optional) &£v.s control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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8 . 5 £I!i5-=^ay^.Iti£-£I!iS«iEQEIEAblr51-CQii£IL£S 

This procedure runs the FTN5 (ForTraN-5* also known as 
Fortran-77) compiler for the CYBER 170. 

The procedure is arranged so that if there are any comp i I e-t ime 
errors detected* the NOS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the compiler. 

Parameters to the FTN5 procedure are s 

i or f s 

(optional) name of Input File to be compiled* If you 
don't code the i parameter* FTN5 assumes that the input is 
on a file called compile. 



(optional) name of file to receive the Listing from the 
compiler. If you don't code the I parameter* the compiler 
output appears on a file called listing. This listing 
file is not rewound by the FTN5 procedure. 



(optional) name of file to receive the Binary object code 
generated by the compiler. If you don't code the b 
parameter* the binaries appear on a file called Igo. This 
Igo file is not rewound by the FTN5 procedure. 



fl 



xp 



this (optional) parameter specifies the Field Length to be 
used while running the compiler* If you don't code this 
parameter* FTN5 uses a field length of 70000(8). 



this (optional) parameter is used to pass extra Parameters 
to the compiler (see the FTN5 reference manual for a list 
of allowed FTN5 control statement parameters). If you 
want to pass extra parameters* the list of them must be 
specified as a string (within single quotes). The FTN5 
procedure does not check the validity of the parameters In 
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the string* If you don't code this parameter* no extra 
parameters are passed to the compiler* 



debug or nodebug : 

these (optional) ls.sy.5. select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID)* If you code the debug Issr* FTN5 includes the debug 
information in the object code fife* If you code the 
nodebug &e.x or if you don't code either of these keys* 
FTN5 doesn't generate the debug information* 



•rsg or nomsg : 

these {optional) &e.y.s control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 
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8 . 6 CQfi£Aii-=-&Uli-ItiE-£atl£ ASS-ASSfiafiLER 

COMPASS runs the CPU/PPU assembler (COMPASS) for the CYBER 170. 

The procedure Is arranged so that If there are any assembl e-t tme 
errors detected, the NOS Job Control Register called EF Is set to a 
non-zero value* This feature Is used when this procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the assembler. 

Parameters to the COMPASS procedure are s 



i or f 



fl 



xp 



(optional) name of Input File to be assembled. If you 
don f t code the I parameter* COMPASS assumes that the input 
is on a file called compile. 



(optional) name of file to receive the Listing from the 
assembler. If you don't code the I parameter, the 
assembler output appears on a file called fisting. This 
listing file is not rewound by the COMPASS procedure. 
(Note that the assembler's control statement parameter 
is set to the same file as specified by the L parameter 
only when the nomsg option (see below) is specified.) 



(optional) name of file to receive the Binary object code 
generated by the assembler* If you don*t code the b 
parameter, the binaries appear on a file called Igo. This 
Igo file is not rewound by the COMPASS procedure. 



this (optional) parameter specifies the Field Length to be 
used while running the assembler. If you don f t code this 
parameter, COMPASS uses a field length of 70000(8). 



this (optional) parameter is used to pass extra Parameters 
to the assembler (see the COMPASS reference manual for a 
list of allowed control statement parameters). If you 
want to pass extra parameters* the list of them must be 
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specified as a string (within single quotes)* The COMPASS 
procedure does not check the validity of the parameters in 
the string. If you don»t code this parameter* no extra 
parameters are passed to the assembler* 



msg or nomsg : 

these (optional) &£*$ control the generation of 
Informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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CPAS180 runs the CYBER 180 CPU assembler. The procedure has two 
modes of operation t 

1. "normal mode" in which object code is generated from the 
source program 

2. "systext mode" in which a "system text** file is produced 
(containing pre-assembl ed PRGCs* etc.) that is used later as 
input to "normal mode" assemblies {see the BLOSYST keyword 
parameter described below) 

The procedure is arranged so that if there are any compile-time 
errors detected* the NOS Job Control Register called EF is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the assembler. 

Parameters to the CPAS180 procedure are 5 

i or f : 

(optional) name of Input File to be assembled. If you 
don't code the i parameter* CPAS180 assumes that the input 
is on a file called compile. 



(optional) name of file to receive the Listing from the 

assembler. If you don't code the I parameter* the 

assembler output appears on a file called listing. This 

listing file is not rewound by the CPAS18Q procedure. 



b : 



chk 



(optional) name of file to receive the Binary object code 
generated by the assembler. If you don't code the b 
parameter* the binaries appear on a file called Igo. This 
Igo file Is not rewound by the CPAS180 procedure. 



this (optional) parameter determines whether the assembler 
checks for correct register types and instruction 
formats. If you code no for this parameter* no checking 
of types and formats is done and the assembler runs 
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faster* If you code yes for this parameter or if you omit 
the parameter* the assembler performs the checks* 



this (optional) parameter is used to specify the name of a 
System text fMe. In "normal mode** this parameter is used 
to provide an alternate to the standard "SYSTEXT" used by 
the assembler* In the "build system text mode"» this 
parameter specifies the name of the file on which the 
system text is written (default is SYSTEXT)* 



fl 



bldsyst 



this (optional) parameter specifies the Field Length to be 
used while running the assembler* If you don»t code this 
parameter* CPAS180 uses a field length of 70000(81* 



If you code this (optional) fcax* CPAS180 runs in the 
**BuiLD SYStem Text** mode. If you don't code this &££• 
CPAS180 runs in "normal** mode* 



msg or nomsg : 

these (optional) &£*£ control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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PPAS180 runs the CY8ER 180 PPU assembler. This assembler is a 
modified version of standard CYBER 170 COMPASS so that usage of the 
two assemblers is very similar* 

The procedure is arranged so that if there are any compi | e-t i me 
errors detected* the NQS Job Control Register called EF is set to a 
non-zero value* This feature is used when this procedure is being 
used as a building block* to determine what steps should be taken 
subsequent to running the assembler* 

Parameters to the PPAS180 procedure are : 

i or f 5 

(optional) name of Input File to be assembled* If you 
don't code the {parameter* PPAS180 assumes that the input i 
is on a file called compile* 



(optional) name of file to receive the Listing from the •>' 
assembler* If you don't code the I parameter* the* 
assembler output appears on a file called listing* This! 
listing file is not rewound by the PPAS18G procedure* J 
(Note that the assembler's control statement parameter Of 
is set to the same file as specified by the L parameter 
only when the nomsg option (see below) is specified*) 



(optional) name of file to receive the Binary object code ...» 

generated by the assembler* If you don't code the b > 

parameter* the binaries appear on a file called Igo. This ^ 

Igo file is not rewound by the PPAS180 procedure* £ 



fl 



xp 



this (optional) parameter specifies the Field Length to be 
used while running the assembler* If you don't code this 
parameter* PPAS180 uses a field length of 70000(8)* 



this (optional) parameter is used to pass extra Parameters 
to the assembler (see the COMPASS reference manual for a 



•■* 
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list of allowed control statement par ameter s !• If you 
want to pass extra parameters* the list of them must be 
specified as a string (within single quotes)* The PPAS180 
procedure does not check the validity of the parameters in 
the string. If you don't code this parameter* no extra 
parameters are passed to the assembler* 



msg or nomsg : 

these (optional) lifiis control the generation of 
informative messages by this procedure and are fully 

described in section 1,8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES", 



conv or convert * 

these (optional) fcSIS specify that the output binary 
object code file (specified by the fc parameter) is to be 
connected to the NOS/170 object text format that Is 
described in the £X&E&_L£UGER-&EE£&E!i£E.aA!aUAL. If this 
keyword is omitted the binary object code file produced is 
in the NOS/VE object text format, 
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8.9 U&aia-r-UM&.&ElQaiAILE.SIBMIES 

LINK170 provides an easy way to use the CYBER 170 Loader. 
Although the CYBER 170 Loader is very powerful and flexible* it 
suffers from the disadvantage that you can't talk to it 
interactively* since it reads ahead in the control statement file* 
and that means that you can only drive it via canned sequences of 
JCL* This procedure provides a simple to use interface to the 
loader which allows for most common types of linking* Parameters to 
the LINK170 procedure are * 



(optional) fist of Files containing the relocatable 
binaries that you want LINKed. If you don't code the f 
parameter* LINK170 assumes that the relocatables are on 
file Igo. The f parameter may be coded as a mufti valued 
list of sublists. Each element of the value list is 
either a single name* in which case it refers to the name 
of an object code file already assigned to the job* or in 
the current user's catalog* fit an element is a sublist* in 
which case* the last sub element in the sublist is a user 
name in whose catalog the object code files referred to by 
the other sub elements of the sublist may be found. The 
example at the end of this description should {with luck) 
nake this clear. Note that files for which a user name is 
specified are returned when the link is completed* 



b s 



(optional) name of file to receive the LINKed program. If 
you don't the b parameter* LINK170 places the linked 
program on file I gob. 



(optional) list of library files from which external 
references are to be satisfied. The p parameter may be 
coded as a multi valued list of sublists* Each element of 
the value list is either a single name* in which case it 
refers to the name of an user library already assigned to 
the job* or in the current user's catalog* ox an element 
is a sublist* in which case* the last sub element in the 
sublist is a user name in whose catalog the libraries 
referred to by the other sub elements of the sublist may 
be found. The example at the end of this description 
should (with tuck) make this clear. Note that libraries 
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for which a user name is specified are returned when the 
Hnk is compi eted* 



(optional) name of file to receive the map Listing from 
LINK170* If you don't code the I parameter* the loader 
uses the default map file name (normally output)* 



lo 



ep 



xld 



debug 



(optional) List Options for the LINK170 process* If you 
don't code the lo parameter* the loader uses its default 
list options* If you simply code lo without any values 
supplied* LINK170 sets default values lo«sb* If you code 
lo*full* LINK170 turns on FULL list options (which are 
lo*sbex). Otherwise* LINK170 sets whatever list options 
you say* 



(optional) specifies a list of Entry Points to be included 
in the header of a multiple entry point "overlay 1 ** This 
list is specified as a s.tLioa &&a££ly. as the list should 
appear on the NOGO loader directive (a string is used to 
allow the specification of so-called "special** entry 
points which have a syntax unacceptable to SES)* 



(optional) list of extra Loader Directives* This 
parameter takes the form of a list of character strings 
which are inserted into the control statement stream* in 
addition to those normally generated* thus allowing you to 
supply extra directives over and above the standard ones* 



(optional) controls whether the linked program includes 
the CYBIL INTERACTIVE DEBUGger (CCDBG) or the CYBER 
INTERACTIVE OEBUGger (CID)* If you code the debug 
parameter* the program will be able to be run under 
control of the requested debugger (by preceding a call to 
the program with the control statement DEBUG(ON))* Legal 
values are CCDBG AND CID* If no value is given* CCDBG is 
used* NOTE: if DEBUG is specified* the tables used by the 
debugger are placed on file ZZZZZOT* This file must also 
be saved and made local if the absolute binary is to be 
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used at a later time. 



cybclib or iswllib s 

these {optional) &2V.S. provide a convenience when linking 
programs written in the CYBIL or ISWL languages 
(respectively). If you are linking such a program* you 
are advised to use the appropriate one of these &&y.s 
(hopefully obvious by their names) for the language in 
question* since such usage causes the LINK170 procedure to 
acquire the necessary library and* generate any other 
necessary loader directives associated with LINKing a 
program in the designated language. 



el or err I evl s 

this (optional) parameter controls the £rror Level at which 
the loader aborts without producing any absolutes. Valid 
values for the el parameter are s 

NONE only ••terminal" errors cause an abort. 
FATAL only fatal errors cause an abort. 
ALL all errors (both fatal and nonfatal) cause an abort. 
ALL is the default for LINK170. 

A default value for the el parameter may be set up via the 
errlevl profile variable if you don»t wish to keep 
overriding the default by coding the parameter. 

status : 

status is an (optional) parameter used for those cases 
where LINK170 Is being used as a building block of more 
sophisticated procedures or jobs. The status parameter 
causes LINK170 to set one of the job control registers to 
the value zero if LINK170 successfully completed* and non 
zero if anything went wrong during the run of LINK170. 
The only values that may be coded for the status parameter 
are one of Rl* R2* R3 or EF. Any other value coded causes 
an error message to be output* and LINK170 aborts. 



Examples of LINK170 Usage 
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ses«finkl70 b*txtform# l*mapform* lo 

* END LINK170 TXTFQRH 

This example shows LINK170 used to link a program. The 
relocatable binaries are assumed to be on file lgo* and the LINKed 
program appears on file txtform. A partial load map Is written to 
file mapf orm. 

ses*Hnkl70 p*(myl ib*your I ib) themap full cybclib debug 

* END L1NK170 LGOB,ZZZZZDT 

This example illustrates the use of multiple user libraries and 
in particular the use of the CYBIL run-time library* The 
relocatable binaries are assumed to be on file lgo# the linked 
program (with CYBIL INTERACTIVE DEBUG) is written to file fgob and a 
full load map is written to file themap. Debug symbol tables are 
written to file zzzzzdt. 



ses*!inkl70 b*abs» p»( some I i b* ( ut i 1 1 i b. jbf )) • •• 
••? f»((relo# oreo» jeell 
* ENO LINK170 ABS 

This example shows files relo and oreo* belonging to user jee» 
being linked using library somelib* which is either local to the job 
or belongs to the current user* and library utillib which belongs to 
user jbf. The linked program is written to file abs* Files relot 
oreo* and utillib are returned when the link is completed* but file 
somelib is left local* 
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GETCCD8 provides an alternate way to acquire CYBIL INTERACTIVE 
DEBUG <CCDBGJ* Normally* CCDBG is acquired ahen necessary by the 
LINK170 procedure* If the LINK170 procedure is not to be used In 
the current session* though* the necessary files must be explicitly 
attached. There are no parameters to the GETCCOB procedure. 



Example of GETCCOB Usage 



ses* getccdb 

* CYBIL INTERACTIVE DEBUG AVAILABLE 
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GETLIB(S) acquires the CY8CLI8 or CYBILIB library ready for 
linking* Parameters to GETLIS(S) are s 

cybcMb or cybillb s 

these (optional) &£is. inidicate which library is required 
to be wade local* Coding the cybclJb &££ acquires the 
CY8IL-CC library* while coding the cybilib fc££ acquires tne 
CY8IL-CI library. 



Examples of GETLIBfS) Usage 



ses.getlib cybcllb 

* END GETLIB CYBCLI8 IS LOCAL 



ses.getlibs cybilib 

* END GETLIBS CYBILIB IS LOCAL 
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9.0 Cia£E«iaa-iIEiyAU£iiiiaQ!iJi£MI.(lE£^IIQti«4Ma-iIllULAIIQi 



"Simulation ain't what it's going to be" 

New Scientist 



This chapter describes the SES utilities for creating and using 

the CYBER 180 Virtual Environment on the CYBER 170. The chapter 

following describes the CYBER 180 Object Code Utility. Facilities 
described in this chapter are * 

SIH180 run the CYBER 180 Hardware System Simulator. 

TQ180 convert a NOS/170 text file for use with the simulated 
NOS/VE I/O available through the SIN180 procedure. 

T0170 NQS/170 to NOS/170 INTERFACE file conversion. 



FR0N180 convert a simulated NOS/VE I/O text file to a NQS/170 text 
f i le. 



FR0H170 converts NOS/170 INTERFACE format files to NOS/170 format. 
DUNP180 dumps the contents of a simulated NOS/VE file. 
DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 
GENCPF link CYBER 180 binaries and generate a Checkpoint File. 
VELINK link CYBER 180 binaries and produce Segment Files. 
VEGEN generate a CYBER 180 Checkpoint File from Segment Files. 
GETLIBCSIget CYBIL run time library local to job. 
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GETDSX make HCS IOU Deadstart tape generator local to job» 
GETLDB make HCS NOS Environment Interface Loader local to job. 



COMPANY PRIVATE 



9-3 
COC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 171 User's Handbook REV* AS 

9.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION 

2il»H2i22 l* R 2!L T t!iLi:Pi R *,122 H i RO !i£ R L s J s JI!L5 I !!l!i£I2 R 

SIM180 runs the CYBER 180 Hardware System Simulator (often 
referred to as the HSS). The hardware system that is simulated 
consists of the following components * 

1. CPU 

2* Central Memory (16 Megabytes) 

3* 10(10) Peripheral Processors (PPs) 

4. 12(10) I/O Channels 

5. 2 7154 disk controllers sharing 4 844-4x disk storage 
units* 

6* 2 7155-1 disk controllers sharing 2 844-4x and 2 885-lx 

disk storage units* 
7* 2 7155-14 disk controllers sharing 2 844-4x> 2 885-lx 

and 2 885-42 disk storage units* 

SIM180 sets up the total system simulated environment and gives 
control to the CYBER 180 simulator* At this point* the user may 
enter any valid simulator command (refer to document ARH1729 - 
"CYBER 180 SIMULATOR ERS W for command descriptions)* Simulator 
commands provide the user with control over the simulated 
environment which includes the following capabilities 3 

1* CPU and ?? memory loading 

2* Interpretive CPU and ?? instruction execution 

3. CPU and ?? breakpoint 

4* CPU and ?? trace 

5* Display and change Central and PP memories 

6* Dump Central and ?? memories to a specified file 

7* Display and change CPU and PP registers 

8* Checkpoint / Restart 

9, On/off CPU and PP simulation 

10* CPU keypoint 

11. CPU program performance monitoring 

The CYBER 180 simulator is intended primarily for interactive use 

(local mode) but may be readily used in batch* An example of batch 

submission of a Simulator run is given below* Parameters to SIM180 
are : 



restart or rs : 

(optional) name of a checkpoint file from which to restart 
simulation* The checkpoint file may be one previously 
created by GENCPF (££fc|erate Check£oint £ile)» VEGEN 
(Virtual Environment GE&erator)* or via the simulator 
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CHECKPOINT command* If you don't code the restart 
parameter* a complete simulated system is created* 

cf : 

(optional) name of a command file which Is to be processed 
immediately upon activation of the simulator* The command 
file consists of one or more valid simulator command(s)* 
This parameter is required alien running in batch* 

1180 or i : 

(optional) name of file containing input for the special 
simulator CPU I/O Instruction (op code FF(16))« If you're 
running SIM180 interactively and don't code the .180 
parameter* S I Ml 80 takes its input from a file assigned to 
your terminal* If you run SIM180 in batch and use the CPU 
I/O instruction for input* you must supply a file 
containing the input* 

0180 or o : 

(optional) name of file to receive output from the special 
simulator CPU I/O instruction (op code FF(16H* If you're 
running SIM180 interactively and don't code the ol80 
parameter* SIM180 sends output to a file assigned to your 
terminal* If you run SIM180 in batch* you must supply a 
file to receive the output* otherwise the output is lost* 



Examples of SIM180 Usage 

ses*siml80 

** I SM 6052: CYBER 180 SIMULATOR VER 6.4 LEV 126 CMIGOS REV SI 

This example shows SIM180 used interactively* to create a new 
simulated system environment* The user may enter any simulator 
command once the simulator banner is displayed* 

ses*siml80 rs*checkl cf*errata 

** I SM 6052: CYBER 180 SIMULATOR VER 6*4 LEV 126 CMIGDS REV S) 

This example shows SIM180 used to resume simulation from a 
checkpoint file* The command file errata is processed before 
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requesting additional simulator commands from the user* 

ses.simldO checkx i«indata o«outdata 

** I SM 6052* CYBER 180 SIMULATOR VER 6,4 LEV 126 tMIGDS REV S) 

This example shows SIM180 used interactively* to resume 
simulation from the checkpoint file checkx. The special simulator 
CPU I/O instruction* when encountered during CPU instruction 
simulation* is to read input from file indata and is to write output 
to file outdata. 

ses.do batchn# f i I e*si mcf • • •••• 

••? cs*( • ses.s inl80 postds* cf*sincft o*progout*». •••• 

• •? • save* sesl og 1 ) 

15.54.28. SUBMIT COMPLETE. JQBNAME IS AAAQCBN 

* JOB DO SUBMITTED 

This example shows SIM180 submitted for batch running via the SES 
DO procedure* Simulation will resume from the checkpoint fiie 
postds? the simulator commands in the fiie simcf are processed* and 
any output from the special simulator CPU I/O instruction is 
directed to file progout. Refer to the description of the SES DO 
procedure in the "Miscellaneous Useful Goodies" section for an 
explanation of using DO to submit multiple control statements to 
b atch. 
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T0180 converts a NOS/170 file containing character data to 
SIMULATED NOS/VE file format. Only character data can be 
converted* Parameters of T0180 are? 



i or f 



The Input or File parameter specifies the NOS/170 format 
file to be converted* 



The (optional* Output parameter specifies the SIMULATED 
NOS/VE format file to receive the converted data. If this 
parameter is omitted then the output and input file names 
are the same. 



cs612 or cs64 

These (optional) k&is. indicate whether the NOS/170 format 
file is upper/lower case ascii (cs612) or whether it is a 
64 character set ascii or display code file (cs64). If no 
keyword is given then cs612 is used* 
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T0170 converts a NOS/170 file containing character data to the 
NQS/170 INTERFACE format of simulated NOS/VE I/O. It is similar to 
T0180 except that the output file content is different. Parameters 
to TQ170 are s 



I or f : 

Name of the Input £ile to be converted* 



o ? 



{optional) name of file to receive the Output* that is* the 
NOS/170 INTERFACE format data* If you don't code the o 
parameter* the output appears on the file specified by the 
i parameter* 



cs612 or cs64 : 

these (optional) IsfilS specify the character set of the 
input file. T0170 assumes the input file is in cs612 
character set. 



COMPANY PRIVATE 



9-8 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User's Handbook REVs AB 

9.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION 

FRQM180 converts a file in SIMULATED NOS/VE format containing 
character data to NOS/170 format* Conversion stops whenever an 
error is found on the SIMULATED NOS/VE format file. Such errors 
include invalid record headers on the file and non-ASCII data in the 
records. The NOS/170 format file may be printed with an SES. PRINT 
command* or input to any other normal NOS/170 program. Parameters 
of FRQM180 are: 

l or f 

The Input or File parameter specifies the source data* 
SIMULATED NOS/VE format file. 



The (optional) Output parameter specifies the NOS/170 
format file. If this parameter is omitted then Input and 
Output file names are the same. 

cs612 or cs64 

These keywords indicate the character set of the output* 
NOS/170 format file. Upper/lower case ASCII is indicated 
by the keyword cs612 and the keyword cs64 indicated a 64 
character set ASCII or display code. If this parameter is 
omitted then cs612 is used. 
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FR0M170 converts NOS/170 INTERFACE format file containing 
character set data to NOS/170 format. Conversion stops when an 
error is found in the NOS/170 INTERFACE format file. Such errors 
include invalid record headers in the file* and non ASCII data in 
the records* The NOS/170 file may be printed via the SES PRINT 
procedure* or input to any other normal NOS/170 program* Parameters 
to FR0N170 are s 



i or f 



name of Input £ i I e to be converted* 



(optional) name of file to receive the Qutput of FR0M170* 
If you don»t code the o parameter* the output appears on 
the file specified by the i parameter* 

cs612 or cs64 : 

these (optional) Ke.y.5 specify the character set of the 
output file* and correspond to the same parameters on the 
FRQN180 procedure* 



COMPANY PRIVATE 



9-10 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 

9.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION 

DUMP180 dumps the contents of a simulated NOS/VE file. It is 
sisal far to HEXDMP except that it checks the records and data 
structure of the file and diagnoses errors which prevent FRGM180 
from converting the file. Parameters to DUMP180 are 5 

i or f i 

name of the file to foe dumped. 



O 5 

(optional) name of file to receive the dump. If you don f t 
code the o parameter* the dump output appears on file 
output. 

cs612 or cs64 J 

these Coptional) isjcs specify the character set of the 
output file* as in the FROM180 procedure. 



fw : 



Iw : 



(optional) £irst Mord of the file to dump. The default is 
to start at word 0. 



(optional) Last Mord of the file to dump. The default is 
to dump up to end of information CEOI). 
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DUMP170 dumps the contents of a NOS/170 INTERFACE format file, 
It is similar to DUMP180* except that DUHP170 also checks the record 
and data structure of the input file and diagnoses errors which 
prevent FR0M170 from converting the file* Parameters to DUMP170 are 



i or f s 

name of the Input £i I e to be dumped. 



o : 

(optional) name of Output file to receive the dump* If you 
don f t code the o parameter* the output appears on file 
output* 



cs612 or cs64 ? 

these (optional) k£*s specify the character set of the 
output file* DUMP170 assumes the cs612 character set* 



fw : 



Im : 



(optional) £irst tford from which to start dumping* If you 
don # t code the fw parameter* the dump starts from word 0* 



(optional) Last Mord to be dumped* If you don»t code the 
Iw parameter* the dump goes to end of information (EOD* 
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GENCPF executes the SES Virtual Environment Linker and the SES 
Virtual Environment Generator to produce a Checkpoint File (CPF) 
which can be loaded and executed on the CYBER 180 Hardware System 
Simulator* The user must provide a file containing CYBER 180 object 
text* and can optionally provide a Linker Parameter File (LPF)« a 
set of Monitor Segment files* and/or a Virtual Environment Generator 
OIRective file. The mf file contains the map produced by the 
Virtual Environment Linker and additional information produced by 
the Virtual Environment Generator. 

Notes most of the following parameters aren't needed by the 
"general public** (examples show general usage). 

Parameters to GENCPF are? 



ofl : (Fi I ename(s )• optional) 

Ob ject_Fi le.Llst - list of up to 10 names of files 

containing CYBER 180 object text (ver 1.0). This 

parameter does not have a default. 

Ifl : (Filename(s)* optional) 

L i brary_F i I e.LI s t - list of up to 10 names of Library 
files containing CYBER 180 object text. This parameter 
does not have a default. 



pep : (StringOD* optional) 

Pr J mar y_Entr y.Po int - This parameter specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symbol encountered. 

ns 2 (String 141 » optional) 

Name_Seed - This parameter specifies the "name seed** for 
the Virtual Environment Linker Segment files* The default 
for this parameter is segm. The value of this parameter 
overrides any Linker Parameter File specification of this 
field. 



(Filename • optional) 

Map. File - This parameter specifies the name of the map 
file. The default for this parameter is linkmap. 
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mo 



this (optional) parameter determines the linker flap 
Options* mo determines the amount of information output on 
the linker map* Any value coded for mo overrides the 
default options chosen by the linker parameter file (LPF)* 
The value of the mo parameter is 2Q£ of the following 
characters s 

H no map information; diagnostics are output* 

S Section allocations for every section of every input 

object module* 
E section allocations plus Entry point names and address 

assi gnments* 
M section allocations and entry points plus output 

segment and common block allocations {this last option 

is in fact a full linker map)* 



rewind or norew : 

these (optional) &S1S determine whether to &£JiI&Q the 
linker map file before writing It* The default action is 
to rewind the map file* The Kay. coded overrides any linker 
parameter file specifications* 



Ipf 



(optional) name of Li nker.Par ameter_Fi I e containing Linker 
parameters that affect the link process* If you don f t code 
the Ipf parameter* default values are applied as in the 
description of the LPF* 



cpf s (Filename* optional) 

Checkpoint_Fi I e - This parameter specifies the name of the 
file containing the output from the Virtual Environment 
Generator* The default is cpfile. The value of this 
parameter overrides any Linker Parameter File 
specification of this field* 

cybilib J (Keyword* optional) 

If you code the (optional) &££• GENCPF uses CYBILIB to 
satisfy externals during the Linking process* GENCPF 
ACQUIRERS CYBILIB from SES and adds it to the 
Library.Fi le.List* The default is not to use CYBILIB as 
part of the Link* 
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dlr or Idrdir or d 5 (Filename* optional) 

Directives - This parameter specifies the name of a fiie 
containing directives to the VE Generator. The default is 
a file containing default directives* 

mtrns or mns s (StringC^)* optional) 

Monitor Name^Seed - This parameter specifies the "name 
seed** of the Virtual Environment Linker Segment files that 
contain the Monitor code, This parameter is provided so 
users can have their own Monitor program* The default for 
this parameter is mtrx. The procedure checks the local 
files* the local PF catalog* and then the SES catalog to 
get the f i les* 



Examples of GENCPF Usage 

The following example shows how to compile a test program written in 
CYBIL* generate a VE File* and run it on the Simulator* 

ses*cybil ci i'testprg t*testlst b*test!go 
ses*gencpf ofl*testlgo cpf*testepf cybilib 
ses*siml80 res tar t*testcpf 
? run 
? bye 

The last two lines were Simulator commands* 

The next example shows how to generate a CPF from several input 
files of CYBER 180 object text* 

ses*gencpf of 1 »(my I gol*my I go2) cpf*mycpf cybilib 
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VELINK executes the Virtual Environment Linker* which links data 
from CYBER 180 object files/libraries and produces a map file and a 
set of SEGMent files* VELINK is set up so that users can specify 
their own Linker Parameter' Fl I e (LPF) containing Virtual Environment 
Linker variables that control the linkage* For more information on 
this* refer to the SES Virtual Environment Linker ERS CARH2816). 

Notes VELINK is generally used only in special cases* where 
GENCPF is inadequate. 

Parameters to VELINK are? 

ofl i <Fi lenameCs )* optional) 

Qb ject.Fi le_Li st - list of up to 10 names of files 

containing CYBER 180 object text (ver 1.0). This 

parameter does not have a default. 

Ifl : (Fi lename(s)* optional) 

Llbr ary_Fi 1 e_List - list of up to 10 names of Library 
files containing CYBER 180 object text. This parameter 
does not have a default. 

pep i CStrlngOD* optional) 

Pr imary_Entry_Po int - This parameter specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symbol encountered. 

ns s <Strfng(4)» optional) 

Name^Seed - This parameter specifies the "name seed" for 
the Virtual Environment Linker Segment files. The default 
for this parameter is segn. The value of this parameter 
overrides any Linker Parameter File specification of this 
field. 

mf * (Filename* optional) 

Map.File - This parameter specifies the name of the map 
file. The default for this parameter is llnkmap. The 
value of this parameter overrides any Linker Parameter 
File specification of this field* 
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no 



this (optional) parameter determines the linker fiap 
Qptions. ino determines the amount of information output on 
the linker map. Any value coded for mo overrides the 
default options chosen by the linker parameter file (LPF). 
The value of the mo parameter is aQ£ of the following 
characters ? 

N no map information; diagnostics are output* 

S Section allocations for every section of every input 

object module. 
E section allocations plus Entry point names and address 

ass ignments. 
M section allocations and entry points plus output 

segment and common block allocations (this last option 

is in fact a full linker map). 

rewind or norew : 

these (optional) fc£y,a determine whether to EEMIHQ the 
linker map file before writing it. The default action is 
to rewind the map file. The &§* coded overrides any linker 
parameter file specifications. 

Ipf : 

(optional) name of L i nker_Parameter_Fi le containing Linker 
parameters that affect the link process. If you don f t code 
the Ipf parameter* default values are applied as in the 
description of the LPF. 

cybilib : (Keyword* optional) 

If you code the (optional) kgy.* VELINK uses CYBILIB to 
satisfy externals during the linking process* VELINK 
ACQUIRE's CYBILIB from SES . and add it to the 
Li brary.F i I e.List. The default is not to use CYBILIB as 
part of the Link. 



Example of VELINK Usage 

In the following example the Linker is passed a Linker Parameter 
File. Object files york and hunt are linked using racetlb as an 
object library* 
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mmmmmmmmmmmmmmmm *rmm mm m m m mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm mm mm mm m mm 

ses.velink of I *( york> hunt ) I f I *my I i b fpf*i*yipf 

* END VELINK 
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VEGEN executes the SES Virtual Environment Generator to produce a 
Checkpoint File (CPF) which can be loaded and executed on the CYBER 
180 Hardware System Simulator. The input to the Virtual Environment 
Generator is the set of Segment files containing the users program* 
and a default set of segment files that contain a simple monitor 
program. The monitor program contains code that sets up the 
exchange packages* stack areas* and also provides a primitive 
Monitor and Trap Handler routines* and a Termination routine* For 
more information on the Virtual Envir onment Generator* refer to the 
" SES Virtual Environment Generator ERS W <ARH2591). 

Note: VEGEN is generally used only in special cases* where GENCPF 
is Inadequate. 

Parameters to VEGEN are* 



dir or Idrdir or d * {Filename* optional) 

Directives - This parameter specifies the name of a file 
containing directives to the VE Generator. The default is 
a file containing default directives. 

ns * CStringC^)* optional) 

Name^Seed - This parameter specifies the "name seed" of 
the Virtual Environment Linker Segment files. The default 
for this parameter is segm. 

mtrns or mns * CString(4)* optional) 

Monitor Name^Seed - This parameter specifies the "name 
seed H of the Virtual Environment Linker Segment files that 
contain the Monitor code. This parameter is provided so 
users can have their own Monitor program. The default for 
this parameter is mtrx. VEGEN checks the local files* the 
current user's catalog* and then the SES catalog to get 
the f i les. 



cpf : (Filename* optional) 

Checkpoint^Fi le - This parameter specifies the name of the 
file containing the output from the Virtual Environment 
Generator. The default is cpfile. 
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nf : (Filename* optional) 

Map_File - This parameter specifies tfie name of the file 
on which to write the *ap information* The default is 
I i nkmap. 



Example of VEGEN Usage 

In the following example* the Generator is passed a directive file* 
a set of segment files containing the test program* a set of monitor 
files* and produces a CPF and Map file. 

ses.vegen dir«mydir ns* l test i mtrns**iitrx* cpf«mycpf »f»»yiiiap 
♦ END VEGEH 
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9.11 S£ILia-Qa.S£ILiaa-r-^fiUIE£-LiaE4EX«£Qg.LIMItiS 

GETLIB(S) acquires the CY8CLI8 or CY8ILI8 library ready for 
linking, Parameters to GETLI8CS) are s 

cybcl ib or cybl lib s 

these (optional) j££¥5, inidicate which library is required 
to be made local* Coding the cybclib &e.y. acquires the 
CYBIL-CC library* while coding the cybllib fce.* acquires the 
CYBIL-CI library* 



Examples of GETLIB(S) Usage 



ses.getlib cybclib 

* END GETLIB CYBCLIB IS LOCAL 



ses.getlibs cybilib 

* END GETLI8S CYBILIB IS LOCAL 
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GETDSI acquires the absolute binary to run the HCS IOU deadstart 
tape generator. There are no parameters. 



Example of GETDSI Usage 



ses.getds i 

* END GETDSI VGENDSI IS LOCAL 
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GETLD8 acquires the absolute binary to run the HCS Environment 
Interface loader* There are no parameters. 



Example of GETLDB Usage 



ses.get I db 

* END GETLDB VGENLDB IS LOCAL 
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io.o £Quac£-£aQ£-uiiLiix-aii-!sa£-iz& 



SES provides a series of procedures for access to the NQS 170 
prototype i rap lementat I on of the Source Code Utility. A detailed 
description of SCU commands is available in the ERS for Source Code 
Utility (NOS 170 version) ARH1766. The procedures currently 
available in this category ares 

SCU Acquire the executable binary for SCU* 

SOLO Run the SCU editor in stand alone mode. 

SCUCOHP Generate an SCU modification for a deck. 
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10.1 i£y«=.4Cayi££-£31££IUI4aL£-ai!i4EI«£aE.aay 

SCU acquires the executable binary for the Source Code Utility 
and copies it to a local file named SCU. In response to calling 
this procedure the user may be sent a short message warning him that 
a change has been introduced and that there is additional 
information available through the TOOLREP facility. There are no 
parameters for the SCU procedure. 

The libraries CYBCCMN and CYBICMN which contain declarations for 
interfaces supported by the SES group may be accessed in the form of 
SCU source libraries through the use of the GETCOMN procedure. 
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SOLO is a stand alone version of the SCU editor* that can be us** 
to edit any text file* A delay will be encountered when entering 
and exiting this editor because a temporary library is created on 
entry from which the text file is extracted on exit. Parameters to 
SOLO are * 



base or ba : 

(optional) name of text file to be edited. If you goa«t 
code the base parameter* SOLO uses a local file named 
base. 



result or r s 

(optional) name of file to receive the result of the 
editing session (SOLO doesn't* by default* write the edited 
file back over the text input file specified by the base 
parameter). If you don't code the result parameter* SOLO 
writes the result on a local file named result. 



Input or i • 

(optional) name of input file from which SOLO reads 
commands. If you don't code the input parameter* commands 
are read from input. 

list or I : 

(optional) name of file on which the editor displays are 
written. If you don't code the list parameter* SOLO writes 
its displays to file output* 
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10.3 S£y£aM™G£M££AI£-£aU-£QS&££inm-££I 

SCUCQMP compares an "old" version of an SCU deck (obtained from 
an SCU source library) with a **new M version of the same deck 
(obtained from a "source" file). The "source" file must have 
neither line identifiers nor deck directives in it. The output of 
SCUCGMP is a file of SCU EOITor commands that transform the "old" 
version of the deck into the "new" version. 

You can select a character to be used as the value of the UNTIL 
parameter on SCU EDITor INSERT and REPLACE commands. The default 
character is the percent sign. If any lines of insertion or 
replacement text end in the "text delimiter* character* they are 
followed on the edit commands file with a line that indicates the 
problem* and the NQS job control register EF is set to a non-zero 
value; otherwise EF is set to zero. Parameters to SCUCQMP are 5 



name or na 5 

ti£fi£ of an SCU deck against which the correction set are 
generated. 



source or s s 

name of a source file containing a modified version of the 
deck. 



ec 



name of a file to which SCU editor commands are to be 
written. 



base or ba : 

(optional) name of an SCU source library containing the 
"unmodified" version of the SCU deck with which the source 
file are compared. If you don f t code this parameter* 
SCUCQMP attempts to access a file named base. 



un s 



td s 



(optional) User Name in whose catalog the source library 
specified by base is to be found. 



(optional) single character value which defines the 
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Ierminating Belimiter to be used on text insertion commands 
generated by SCUCOMP. The value of td may be given as any 
single character* or as a positive integer in the range 
1..127. If you don't code the td parameter* SCUCOMP uses 
the percent sign % as the default character. 

Is or ignorls s 

These (optionall fcsxs specify whether or not to ISSQEe 
Leading Spaces on lines being compared. The default 
action is to recognise leading spaces (the is option). If 
you code the ignorls fce.y. SCUCOMP ignores leading spaces on 
text I i nes. 



Example of SCUCOMP Usage 



ses.scucomp •scm$edi tor_hel p_command» formed • 
ec*modform ba»s!0619 



This example of SCUCOMP compares formatted source statements on 
fife FORMED with the SCU deck SCMSEDITQR.HELP .COMMAND from the 
source library on file SL0619 to build an SCU modification for the 
deck on file MODFORM. In this case lines differing by leading 
spaces were recognised as changed. 
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The Object Code Utilities are a collection of commands which used 
to create and update libraries* modify certain aspects of individual 
modules* and list various types of information for each module* The 
utilities accept as input CYBER 180 object modules in C180 loader 
text format V1.0 generated by CYBER 180 compilers and assemblers 
executing on CYBER 170. Consult the ERS for 180 Object Code 
Utilities (ARH2922) for more details. Here is a brief summary of 
the Object Code Utility commands. The full descriptions follow. 

COM Change Qbject fijodule. Changes characteristics of a module 
in an object library. 

DEOM Qfclete Qbject Module(s) from an object library. 

DION Qlsplay Qbject {lodule(s) information. 

GOL generate Qbject L'hrary. Generates or updates an object 
I i br try. 

GOF generate Qbject £ile. GOF is similar to G0L> except that 
GOF produces a file which is not a library. 
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This section introduces the parameter naming convention common to 
most of the procedures in the CYBER 180 Object Code Utilities* 

file or library name of the object library (or file) on 

which the object modules reside* 

module name of a module or range of modules 

upon name of new library (or file) for those 

procedures which update a library (or 
file). 



fisting name of file to receive listing 

information. 
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The variables described beto* may be declared in your PROFILE in 
order to establish default information for the parameters of the 
CYBER 180 Object Code Utilities procedures. 

lokmode used by all of the procedures that update libraries* to 
determine the default interlock action* lokmode may be set 
to one of •LOCK 1 or 'NGLGCK 1 * See also the sections below 
on updating libraries and interlocking* 

intrlok used by all of the procedures that update libraries to 
specify the interlock file to be used during the update 
process* The default name for this file is intrlok* 
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When updating a library you can interlock the update so that only 
one user at a time can update the library* Those procedures that 
update a library are set up so that if the library to be updated is 
in another user's catalog* the library is interlocked by default* 
You can override default actions by defining a I okmode variable in 
your profile* or by coding a lock or nolock &e.y, on the procedure* as 
sho*n in the diagram on the next page* 

Interlocking of a library is done via an interlock file* Such a 
file silStl be a 8Ifc£CI access file i& Jtbe. &£!£ U&exiS aataiaa as. tbfi 
lifecacx ilSiaa U&ilatad'* Naturally the interlock file must be a 
PUBLIC* WRITE MODE file if other users are likely to be using it* 
The default name used by the SES CYBER 180 Object Code Utilities and 
library management procedures for the lock file is interlok. You 
can have an interlock file of any name by defining the intrlok 
profile variable* or by coding a file name as a value for the lock 
parameter on the appropriate procedures* 
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&aiiaa IaJsaa 



lock 



» library or base is locked 
« lokmode profile variable o 



regardless of contents of 
r other conditions* 



nolock i library or base is Dfii I oc 
J of lokmode profile variabl 



ked regardless of contents 
e or other conditions* 



blatfcioa 



Cadad ia Etafiis 
\ lok«ode« , L0CK« 



Aaiiaa Iafcaa 



lokmode 



* libra 
! unf es 

! parara 

, + , — 

•NOLOCK*? libra 
$ unies 

! par am 

* — + 



ry or base is locked 
s overridden by notock 
eter on procedure* 



ry or base is aat locked 
s overridden by lock 
eter on procedure* 



Kaliiiaa 



Quasi: Q£ Base 
Qi Lifc£a£i 



4siiaa Iaksa 



Current User 



library or base is aai. 
locked unless the lokmode 
profile variable is set 
to *LGCK« or the lock 
parameter is coded on the 
procedure* 



Another User 



library or base is locked 
unless the lokmode 
profile variable is set 
to •NOLOCK* or the nolock 
parameter is coded on the 
procedure 
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11.1 £Qli-=.&tiAlifi£..Q&iLE£I-!iQfiULE 

COM Changes an Object Module in an object library. Various 
characteristics of the module may be changed* such as entry point 
names which may be substituted or removed* gated entry points may be 
designated or removed* and commentary may be changed* Parameter to 
COM are : 

file or f or library or lib 5 

name of file Cor library) containing the module to be 
changed* plus an (optional) user name specifying the 
catalog where the file (or library) resides if it is not in 
the current user , s catalog* The specified file may or may 
not be a library, but if the keyword used is lib or library 
* it must be a library* Whether the upon file is a library 
is determined by the format of this input file* If you 
code a file name and a user name* they must appear as a 
list* the first element of which is the name of the file* 
and the second element the name of the user in whose 
catalog the file resides* for example : f*(date* palm) to 
get file date from the catalog of user palm. 

module or mo • 

name of the module in the library to be changed. 



nn 



S 3 



(optional) name which replaces the name of the specified 
modu I e. 



(optional) entry point pair(s) whose names are to be 

substituted* The pairs are of the form Kold entry 

point>*<new entry point>) where <old entry point> is 
replaced by <new entry point>. 



oiait or o : 

(optional) entry point(s) whose definitions are to be 
removed from the output module* 



gate or g 5 

(optional) entry point(s) that are to be gated in the 
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output nodule. Gated entry points can be entered from any 
ring within the files call bracket* 



ng 



pro 



(optional) entry point(s) for which the gated attribute is 
to be removed. 



(optional) entry point at which execution is to begin 
( transfer symbol ) • 



comment or co s 

(optional) contents of the commentary field in the module 
header. 



upon or up * 

name of file to receive the updated file (or library)* plus 
an (optional) user na«e in whose catalog the file (or 
library) resides* if the file (or library) is not in the 
current user f s catalog. Whether the upon file is a library 
is determined by the format of the input file. If you code 
a file name aod a user name* they must be coded as a list* 
the first element of which is the name of the file* and the 
second element the user name in whose catalog the file 
resides. If you just code the file name and no user name* 
the upon file is placed in the catalog of the current 
user. If the user name refers to another user's catalog* 
the upon file suit alX£adl £&i&£ in that user's catalog. 

lock or nolock : 

these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the jlfifauii 
action when the library being updated is in another user's 
catalog. If you don't code either of the lock or nolock 
&£1S,* interlocking is controlled by the lokmode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there's no such profile variable* 
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the name intrlok is used as the lock filename. The 
interlock file iMSi be in the same catalog as the library 
being updated. If the interlock file cannot be found* the 
procedure aborts. 



«sg or noasg : 

these f optional) &.£££ control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 
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Examples of COM Usage 

ses.com library! ibl modul e*modx nn^mody upon*lib2 

* MODULE MQDX CHANGED ON FILE LIB2 

This command creates a new library* Ilb2 which is identical to 
library Mbl except that the name of modx is changed to mody. 

ses.com filel modx s»C (epl»newepl) t( ep2»newep2) ) up*( f i I e2» wrb ) 

♦ LOCKING FILE2 VIA INTRLOK 

* FILE2 LOCKED 

* FILE2 UNLOCKED 

♦ NODULE MODX CHANGED ON FILE FILE2 

This command creates a new file file2 (may be library) identical 
to filel except that entry point name newepl replaces epl and newep2 
replaces ep2. The destin ation file* file2 is given with the user 
name wrb« so the automatic interlocking process takes place during 
the update of f I Ie2« 

ses.com libl mo*modulex o»entl g*ent2 ng*ent3 pro«ent4 •• 

• •? co**cpu aigds review* up*lib2 

♦ NODULE HODULEX CHANGED ON FILE LIB2 

This command creates a new library Iib2 identical to libl except 
that entry points in module modulex are modified as follows s entl 
Is removed; ent2 is set to gated; ent3 is set to not gated; the 
trans symbol is changed to ent4; and the commentary field is changed 
as shown* 
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11.2 QEQfl-=.Q£L£I£-QaiECI-ttQaULEiSl 

DEOM QE'tetes Object £|odule(s) or ranges of object modules from an 
object library. Parameters to DEOM are s 

file or f or library or lib s 

name of the file lor library) from which module(s) or 
module subrange(s) are to be deleted* plus an (optional! 
user name in whose catalog the file or library resides if 
it isn't in the current user's catalog. The specified file 
may or may not be a library* but if the keyword used is lib 
or library* it must be a library. Whether the upon file is 
a library is determined by the format of this input file. 
If you code a file name ami a user name* they must appear 
as a list* the first element of which is the name of the 
file* and the second element the name of the user in whose 
catalog the file resides* for example : f*(coconut* palm! 
to get file coconut from the catalog of user palm. 

module or mo i 

modufe(s) or module subrange(s) to be deleted from the 
file* If a specified module is not on the file* a fatal 
error is issued. 



upon or up 5 

name of the file lor library) on which the remaining 
modules are written* plus an (optional) user name in whose 
catalog the updated file (or library) is to be placed* if 
it is not in the current user's catalog. Whether the upon 
file is a library is determined by the format of the input 
file. If you code a file name aad a user name* they must 
be coded as a list* the first element of which is the name 
of the file* and the second element the user name in whose 
catalog the file resides. If you just code the file name 
and no user name* the upon file is placed in the catalog of 
the current user. If the user name refers to another 
user's catalog* the upon file must llLS.2.^1 £*is£ in that 
user's catalog. 

lock or noiock s 

these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
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name of the Interlock file. Interlocking is the sisfayli 
action when the library being updated is in another user's 
catalog* If you don't code either of the lock or nolock 
JSSXS? interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the Interactions of the lokmode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
Interlock filename; if there's no such profile variable* 
the name Intrlok Is used as the lock filename* The 
interlock file msi be In the same catalog as the library 
being updated* If the interlock file cannot be found. the 
procedure aborts* 



listing or list : 

(optional) name of listing file on which the names of the 
modules on the new library are listed In the order In 
which they occur as well as the file from which they 
came. If you don't code the list parameter* no "listing" 



output Is produced, 



nsg or nomsg : 

these (optional) &£*.& control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES 1 *. 
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Examples of DEOM Usage 

ses.deom library*Hbl modu!e*modx u?on*Hb2 
* NODULES DELETED ON FILE LIB2 

This cowhand creates a library Ilb2 identical to flbl except that 
lodufe modx is deleted. 



ses.deom file*<filel> userl) mo*Cmoda..modb»modc) up»file2 
* MODULES DELETED ON FILE FILE2 

This command creates a file flle2 lis library if fllel is 
library) identical to fllel except that modules between moda and 
modb inclusive and mode are deleted. The file Cor library) filel is 
being obtained from the catalog of userl* 
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DIQIi Qlsplays various pieces of information about Qbject 
$odule(s) in an object library* The format of the list file 
produced is described in the object code utilities ERS (ARH2922). 
Parameters to OIOH are s 



file or f or library or lib s 

name of file Cor library) whose contents are to be 
displayed* plus an (optional) user name in whose catalog 
the file (or library) is to be found* if it is not in the 
current user , s catalog. The specified file may or may not 
be a library, but if the keyword used is lib or library* it 
must be a library* If a file (or library) name aa£ a user 
name is coded* they must appear as a list* for 
example : lib»(offthe* wall) to get library offthe from the 
catalog of user wall. 

module or mo * 

(optional) module(s) or module subrange(s) about which 
information is to be displayed. If a subrange is 
specified* all modules in the subrange are displayed. 
Omission causes all modules in the file or library to be 
di sp I ayed. 



I isting or I ist s 

(optional) name of file on which the display information 
is to be written. Omission causes the information to be 
written to the job output file. 



on 



(optional) level of information to be displayed. Only the 
options selected are in effect. Valid specifications ares 

D time and date module was created 

E entry point definitions of the module 

H module header information 

X external references made by the module 

A all information printed by D* E* H and X (default) 
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Examples of DION Usage 

ses.dio* library*fibl module»«todx iist*listx on«a 

* NODULES FROM FILE LI81 DISPLAYED 

This command lists all information about module nodx of library 
1 ibl on file listx, 

ses.diom f I I e*( f i I ex» 1 osery ) mo»C moda. .wodb* mode) on*td»h«x) 

* HODULES FROM FILE FILEX DISPLAYED 

This command lists date and time created* module header 
information* and external references about modules moda to aiodb 
inclusive and mode of fHex (may be library) on file output 
(default)* The file filex is acquired from the catalog of user 
losery. 
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11.4 fiQL-=-£E!i£& AI£.3fiiE£I-UaBABX 

GOL generates an Qbject Library* or updates an existing object 
library* Also* several files can be combined into one. GOL 
requires that there be an input file specified either by the file 
parameter* or base parameter* 

The add* replace* and combine parameters* specify exactly which 
modules from the file(s) specified by the file parameter to include 
on the new library, while the after and before parameters control 
the position of the new modules* Parameters to GOL are 

file or f or library or lib s 

(optional) list of f i I ename-username pairs describing files 
Cor libraries) from which object modules specified by the 
following three parameters are to be obtained for the new 
library. The specified fileCs) may or may not be 
library(s)* but if the keyword used is lib or library, they 
must be library(s). Each element in the list of file (or 
library) names can either be a single file (or library) 
name* a£ the element can itself be a list of two elements* 
the first is the file (or library) name* and the second is 
the user name in whose catalog the file (or library) 
resides* If only a single element* file (or library) name 
is given* the file (or library) is acquired from the 
current user's catalog* 

The next three parameters (combine* add* and replace) specify 
module(s) or module subrange(s) to be included on the new library 
from the files specified by the file or library parameter* None* 
one* two or all three parameters may be specified* If none are 
specified* all the modules on the files specified by the file or 
library parameter is included on the new library* Only the first 
occurrence of duplicate modules are included in the new library* 
As explained below* the particular parameter(s) used give you 
control over whether the given modules should exist on the base 
1 i br ar y(s ) • 

combine or co : 

(optional) module(s) to be included in the new library. 
The specified module(s) may or may not exist on the base 
llbrary(s)* If they exist* they are replaced* 



add 
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(optional) module(s) to be AOOed on the ne« library. If a 
specified module duplicates a module already on a library 
specified by the base parameter* a fatal error is issued. 

replace or rep : 

(optional) module(s) to be REPLACEd on the new library. 
If a specified module does not already exist in a library 
specified by the base parameter* a fatal error is issued. 

after or af or before or be t 

(optional) module on a base library after or before which 

to position the new modules. Default position is after 

the last module on the last base library. 

base or b or basellb or bl s 

(optional) list of f i lename-username pairs that determine a 
list of base file(s) or library(s) to be included in the 
new object file. All modules from the base files (or 
libraries) become part of the new object file except 
duplicate modules (the first occurrence of the module takes 
precedence). The specified file(s) may or may not be 
library(s)* but if the baselib or bl keyword is used to 
code the parameter* they DDUSi be iibrary(s). Each element 
in the list of files (or libraries) can itself be a list of 
two elements* the first being the name of the file (or 
library)* and the second being the name of the user in 
whose catalog the file (or library) resides. If only one 
element is specified* the file (or library) is acquired 
from the current user's catalog. 



upon or up : 

name of file to receive the generated object library* plus 
an (optional) user name in whose catalog the new object 
library is to be placed* if it is not in the current user's 
catalog. If you code a file name ana* a user name* they 
must be coded as a list of two elements* the first of which 
Is the file name* and the second the user name* If you 
just code the file name* the upon file is placed in the 
current user's catalog. If the user name refers to another 
user's catalog* the upon file msi aJxsasiy. £&is£ in that 
user f s catalog. 



lock or nolock 
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these (optional! parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the d&taiilt 
action when the library being updated is in another user's 
catalog. If you don't code either of the lock or nolock 
&&¥£• interlocking is controlled by the loknode profile 
variable* Refer to the introductory sections of this 
chapter for information on the interactions of the loknode 
profile variable and the lock and nolock parameters. If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there's no such profile variable* 
the name Intrlok is used as the lock filename. The 
interlock file must be in the same catalog as the library 
being updated* If the interlock file cannot be found* the 
procedure aborts* 

listing or I 1st i 

(optional) name of listing file on which the names of the 
modules on the new library are listed in the order in 
which they occur as well as the file from which they 
came. If this parameter is not specified* no "listing" 
output is produced. 



msg or nomsg s 

these (optional) !&£*£ control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 



Examples of 60L Usage 

ses.gol f I le*f ( coconut # pal m)) I i st*rocker upon«nenl i b 
* OBJECT LIBRARY GENERATED 

This command creates a library newlib which contains all the 
modules from file coconut (may be library)* obtained from the 
catalog of user pain* Display information appears on file rocker* 
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ses*gol lib*iftp!ib add»moreof rep*sameas bl*baselib up*newlib 

* OBJECT LIBRARY GENERATED 

This command creates a library newlib identical to library 
basetib except that module sameas from library inplib replaces 
sameas and module moreof from inplib Is added at the end* Display 
information appears on file output (default)* 

ses.gol base»(f i lel.f i I e2* f i I e3) upon*newlib 

* OBJECT LIBRARY GENERATED 

This command creates a library newlib which is the combination of 
libraries filel* file2 and file3* all obtained from the current 
user's catalog* Only the first occurrence of duplicate modules 
appears on the new library* Display information appears on file 
output* 

ses.gol ( f 1 1 ea* f 1 1 eb) co»< tea* • d i nner* n i tecap) after-lunch • • 
••? base*basetib up*nova 

* OBJECT LIBRARY GENERATED 

This command creates a library nova using library baselib as a 
base* Nodules tea thru dinner inclusive and nitecap from files 
fltea and fileb <may be libraries)* both obtained from the current 
user's catalog* are added after module lunch* Display information 
appears on file output* 
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GOF generates an Qbject Eile* or updates an existing object 

file. Also* several files can be combined into one* GOF requires 

that there be an input file specified either by the file parameter* 
or base parameter* 

The add* replace* and combine parameters* specify exactly which 
modules from the filets) specified by the file parameter to include 
on the new object file* while the after and before parameters 
control the position of the new modules* Parameters to GOF are 

fife or f or library or lib s 

(optional) list of f i I ename-username pairs describing flies 
for libraries) from which object modules specified by the 
following three parameters are to be obtained for the new 
object file* The specified filets) may or may not be 
library(s)* but if the keyword used is lib or library* they 
must be I ibrary(s). Each element in the list of file for 
library) names can either be a single file for library) 
name* at the element can itself be a list of two elements* 
the first is the file for library) name* and the second is 
the user name in whose catalog the file tor library) 
resides* If only a single element* file for library) name 
is given* the file tor library) is acquired from the 
current user's catalog* 

The next three parameters (combine* add* and replace) specify 
modulefs) or module subrangets) to be included on the new object 
file from the files specified by the file or library parameter* 
None* one* two or all three parameters may be specified* If none 
are specified* all the modules on the files specified by the file 
or library parameter is included on the new object file* Only the 
first occurrence of duplicate modules are included in the new 
object file* As explained below* the particular parameterts) used 
give you control over whether the given modules should exist on 
the base libraryts)* 

combine or co : 

foptional) modulefs) to be included in the new object 

file* The specified modulefs) may or may not exist on the 

base libraryts)* If they exist* they are replaced* 



add 
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(optional) module(s) to be ADDed on the new object file. 
If a specified module duplicates a module already on a 
library specified by the base parameter* a fatal error is 
i ssued. 



replace or rep i 

(optional) module(s) to be REPLACEd on the new object 
file. If a specified module does not already exist in a 
library specified by the base parameter* a fatal error is 
issued. 



after or af or before or be J 

(optional) module on a base library after or before which 

to position the new modules. Default position is after 

the last module on the last base library. 



base or b or baselib or bl 5 

(optional) list of f i lename-username pairs that determine a 
list of base file(s) or libraryfs) to be included in the 
new object file. AM modules from the base files (or 
libraries) become part of the new object file except 
duplicate modules (the first occurrence of the module takes 
precedence). The specified file(s) may or may not be 
tibrary(s)* but if the baselib or bl keyword is used to 
code the parameter* they iys.£ be I ibrary(s). Each element 
in the list of files (or libraries) can itself be a list of 
two elements* the first being the name of the file (or 
library)* and the second being the name of the user in 
whose catalog the file (or library) resides* If only one 
element is specified* the file for library) is acquired 
from the current user's catalog* 



upon or up : 

name of file to receive the generated object file* plus an 
(optional) user name in whose catalog the new object file 
Is to be placed* if it is not in the current user f s 
catalog. If you code a file name a,QjJ a user name* they 
must be coded as a list of two elements* the first of which 
is the file name* and the second the user name. If you 
just code the file name* the upon file is placed in the 
current user's catalog* If the user name refers to another 
user's catalog* the upon file iu£t aiL&adl £&i&£ in that 
user's catalog. 
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lock or nolock s 

these (optional) parameters determine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the default 
action when the library being updated is in another user's 
catalog* If you don't code either of the lock or nolock 
fcejii* interlocking is controlled by the lokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the lokmode 
profile variable and the lock and nolock parameters* If 
you don't code a filename for the lock parameter* the 
contents of profile variable intrlok is used as the 
interlock filename; if there's no such profile variable* 
the name Intrlok is used as the lock filename* The 
interlock file itt&t be in the same catalog as the library 
being updated* If the interlock file cannot be found* the 
procedure aborts* 



listing or list : 

(optional) name of listing file on which the names of the 
names of the modules on the new library are listed in the 
order in which they occur as well as the file from which 
they came* If this parameter Is not specified* no 
"listing* output is produced. 



msg or nomsg s 

these (optional) itsxa control the generation of 
informative messages by this procedure and are fully 
described in section 1*8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Examples of GOF Usage 

ses*gof f i I e»( ( f i I ex»usx) • (f i ley*usy ) ) list*listx up*newfile 
* OBJECT FILE GENERATED 

This command creates an object file newfile which contains all 
the modules from the object files filex (obtained from the catalog 
of usx) and flley (obtained from the catalog of usy)* File filex 
and flley can in fact be iibrary(s)* Display information appears on 
file listx. 
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ses.gof lib*inplib add*modl rep*nod2 b*baselib up«!nf i I e»nusr I 

* LOCKING NEWFILE VIA INTRLOK 

* NEWFILE LOCKEO 

* NEWFILE UNLOCKED 

* OBJECT FILE GENERATED 

This command creates an object file nfile identical to library 
baselib except that module mod2 from library Inplib replaces wod2 
and module nodi from inplib is added at the end* Note that file 
nfile is specified as being in the catalog of nusr* so the object 
library update is automatically interlocked. Display information 
appears on file output (default). 

ses.gof base»(f Hel»f i !e2* f i I e31 upon*latest 

* OBJECT FILE GENERATED 

This command creates an object file latest which Is the 
combination of libraries filel* flle2 and file3. Only the first 
occurrence of duplicate modules appears on the new library. Display 
information appears on file output. 

ses.gof If I leatf I lebl co«f moda. .modb*modc) after*modx •• 
••? base» < ( base! i b« ol duser )) up*newobjf 

* OBJECT FILE GENERATED 

This command creates an object file newobjf using library baselib 
(obtained from the catalog of olduser) as a base. Modules moda thru 
modb inclusive* and mode* from files fllea and flleb (may be 
libraries) are added after module modx. Display information appears 
on file output. 
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12.0 $QiiE£L_mi-ERE£aQamoa$ 



The utilities described in this section comprise a general set of 
reformatting facilities for source text* They are described briefly 
here* and more detailed descriptions follow. 

CYSFORM a source code formatter for CYBIL 

ISWLFRM a source code formatter for ISWl 

PSEUDO text preprocessor that can generate repetitive sequences of 
text* 

F5F0RH formats Fortran 5 source text* 
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CYBFORM is a source code reformatter for CYBIL* such that program 
readability and consistency of presentation are enhanced. The 
operation of this procedure differs from that described in the 
CYBFORM ERS in that this procedure rewinds both the input and output 
files before and after the reformatting operation. Note that 
CYBFORM can handle multi record files. Parameters to CYBFORH are s 



i or f 



name of Input File containing the CYBIi source text to be 
reformatted. 



{optional) name of file to receive the Output form 

CYBFORM. If you don't code the o parameter, CYBFORH 

places the output on the file specified by the i 
parameter* 
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12.0 SOURCE TEXT PREPROCESSORS 

12,2 ISWLFRM - ISWL SOURCE TEXT REFORHATTER 



12.2 IS*kE&tt-=-ISHk.SQUSCE-IE*I.&£Eaai!AIIE& 



ISWLFRH reformats ISWL source code* such that program readability 
and consistency of presentation are enhanced. Parameters to ISWLFRH 
are: 



I or f s 



O 3 



name of Input File containing the ISWL source text to be 
reformatted* 



(optional) name of file to receive the Output form 
ISWLFRH. If you don't code the o parameter* ISWLFRH 
places the output on the file specified by the 1 
parameter* 



♦- 



Synitx s£ EflciattiQfl Bicsckixfis 

Directives are given to the ISWL formatter by embedding 
certain comment toggle options in the input ISWL source code : 



H $P + M S Select comment formatting. 


*»$?»-•» J Turn off comment formatting. 


W $PR W « Discard existing line numbers* if any* and generate 
! new line numbers. 


W $PN H * Discard existing line numbers* if any* and do not 
S generate new line numbers* 


M $PS H J Preserve existing line numbers. 


W $PB W 5 Preserve existing blank lines. 
W $PU W J Capitalize ISWL keywords. 


w $H<n> H 1 ISWL Hargin chop. Formatter wraps line around at 
■ N-l character position* 



4.-. 



Default selections t "$M72* "%?$* "SP-" 
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12.2 ISWIFRH - ISWL SOURCE TEXT REFORHATTER 



tifitS * ISWLFRM assumes a syntactically correct ISWL program* 
Syntax errors may cause undeslred results on the output file* 



COMPANY PRIVATE 



12-5 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User's Handbook REV? A8 

12,0 SOURCE TEXT PREPROCESSORS 

12.3 PSEUOO - RUN PSEUDQ PREPROCESSOR 



12,3 ES£Uafl-=-&UM-ES£UaQ-£&££&OC£SSOE 

PSEUOO is a text preprocessor nhich enables parameterized 
replication of selected portions of a text file* The parameters to 
this procedure are: 



I or f s 



m 



op 



name of the Input File containing the text to be processed 
by PSEUDO. 



(optional) name of file to receive the Output from 
PSEUDQ. If you don't code the o parameter* PSEUDO 
directs the output to the file specified by the i 
par ameter • 



(optional) name of file to receive the secondary output ( 
Messages) from PSEUDO. If you don't code the m parameter, 
PSEUDO places the Messages output (If any) on a file 
called MSGS. 



(optional) name of the file to receive the statistics (and 

any error messages) from the run. If you don't code the 

op parameter, PSEUDO writes this information to file 
OUTPUT. 
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F5FGRM reformats FORTRAN-5 source text to reflect the nesting 
levels of IF-THEN-ELSE blocks and DO loops. Parameters are t 

iorf J 

name of Input £He containing the FTN5 source text to be 
reformatted by F5FQRM. 



& * 



(optional) name of file to receive the Qutput from F5FQRH* 

If you don f t code the o parameter* F5F0RH places the 

resultant formatted text on the file specified by the I 
parameter. 



Examples of F5F0RH Usage 



ses.f5form i*messy» o»lovely 

* END F5F0RH MESSY -> LOVELY 



ses.f5form modern 

* END F5F0RH NODERN 
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13.0 ££a-£aammKMiQ8s 



U&£i:.££-US&£.G.2ilUQi£a£i2QS 

SES provides a communicat i on system such that users can send 
files between Sunnyvale and Arden Hills* and can also MAIL messages 
to each other. To receive mail* you need a MAILBOX in your 
catalog* A MAILBOX is created by using the SES NEtfMAIL procedure, 
yhen you create a PROFILE using the BuiLO PROFILE IBLDPROF) 
procedure mentioned in the introduction* a MAILBOX is also created. 

SEND send files between Sunnyvale and Arden Hills NOS 
development machines* 

NEWMAIL creates a new mailbox. You also use NEWMAIL when you want 
to "clear out** the contents of the mailbox. 



GETMAIL displays the mail from your mailbox at your terminal* or 
alternatively* the mail can be placed in a file for 
subsequent printing or whatever. 

HAIL send mail to other users. 

SAVMAIL saves the contents of your mailbox. 

ANYMAIL tells you how many items of mail are in your mailbox. 

WHOMAIL tells you who sent the items of mail that are in your 
mal I box. 

CHKHAIL a procedure SEGMENT that you can INCLUDE into your PROFILE* 
so that if there is any mail in your mailbox* you get a 
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message every time you use SES* 
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The HAIL procedure puts a line at the start of every message that 
shows you the user name land possibly the real name) of the person 
who sent you the message. It's possible to have your name (In 
characters) Included in this by defining a myname PROFILE variable 
as a string* as follows : 

\ myname * *Ethel Snerge f 

Now every time you send a mailbox message to somebody via the 
MAIL procedure* the header of the message in the destination mailbox 
reads s 

FROM USER ES91 ( Ethel Snerge ) ON NOV 19* 1977 AT 9*33 AM 



MAIL also provides the facility to equate peoples' real names 
with their user names* so that you can send mail to* say* fred* 
instead of fjc0795 or some other cryptic machine oriented name. You 
can do this by putting statements like this in your profile J 



IF PRQCNAM » »MAIL« 
fred » 'FJC0795' 
bill » 'WAH0001* 
andy * 'AJL6655' 

IFEND 



THEN 



This series of SES directives in your profile defines the names 
given* but only when the procedure being used is MAIL. fciaM* you can 
send mail I I ke this : 

ses.mail letters to (fred* bill* andy) 

Note that when you are using equated names of this type you must 
use the to keyword on the MAIL procedure instead of the un keyword* 
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&£iai£_&aia£Lai£-£saiyai£ai;iaas 



SES provides a set of procedures to submit jobs and manipulate 
permanent files on remote mainframes* linked via the RBF/E20GUT 
network. Here Is a summary of the remote access procedures J 

SUBMIT SU&HIIs a file to be processed as a batch job on the 
specified mainframe* 



GETPF 



SEIs a germanent £ile (direct or indirect J from a remote 
mainframe to a permanent file (direct) on the local 
mai nf r ame. 



SiNDPF iE^Qs a copy of a Eermanent £ I I e (direct or indirectl to 
a direct permanent file on a remote mainframe* 

CHANGPF CfciAiSes parameters of a Eermanent £ile on a remote 
mai nf r ame* 

PURGPF £UB£Es (removes) a permanent £ile from a remote 
mai nf r ame* 



PERMPF 



EESftits another user access to a permanent £ile* 



CATPF 



displays CAIHst information about Eermanent £i I es 
existing on the remote mainframe* 



OISPOSE PRINTs a file from the local mainframe on a printer at 
the remote mainframe* 
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Each mainframe has been assigned a site identifier* These site 
identifiers are s 

ARH - Arden Hills 176 S/N 101 
SVt - Sunnyvale 176 S/N 112 
AS2 - Arden Hills S2 

fciQtfi : As additional systems are added to the network* they are 
assigned a site identifier. 

In addition to the site-id* each user must have a valid user 
name* password* charge number and project number for the target 
machine. These may be coded into your PROFILE. The PROFILE 
variables are created by concatenating the site-id with f fam* for 
faulty name* 'use* for user name* •pas' for password* *cha f for 
charge* and 'pro 1 for project. Users may have PROFILE variables for 
each remote mainframe they are validated to run jobs on. In 
interactive mode* the remote link procs requests the family name* 
user name* password* charge* and project variables if they are not 
in your PROFILE. 

fciatfi • £&a£ la fcatcii tads* tils satiable ius.t e.iis.1 1q z&ut. E8LQ£IL£» 
2L lbs iafc afeatts* 

££Atl£L& * The variables needed for a Sunnyvale user to run jobs 
on the Arden Hills S2 would be s 



PROFILE 






\ AS2USE 


* 'your 


S2 


\ AS2PAS 


■ 'your 


S2 


X AS2CHA 


*■ 'your 


S2 


\ AS2PR0 


« f your 


S2 


\ AS2FAH 


■ *your 


S2 



user fiaie* 
password 9 
charge number 1 
project number* 
family name* 



If the value for a remote site charge parameter is set to a null 
string (for example SVLCHA * '*)* the remote link procedures omit 
the CHARGE statement In the job control statement stream that Is 
sent to the remote mainframe for execution. 

If a remote site family name is set to a null string {for example 
ARHFAM * • •■ I * the family parameter isn't specified on the USER 
statement. 
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13.1 S£iifl. = .iaAllSttlI,ElLEiJ£IM££!i-!iQS-iIIES 

SEND is a facility to transmit files between NOS sites. 

When you SEND a file to a remote user* a copy of the file is 
placed in the special catalog C8E at the remote site. This copy of 
the file is a DIRECT access file which is defined with a UNIQUE 
name* The receiver Is given WRITE permission on the file* and a 
message is mailed to the receiver to inform him of the real name of 
the file you sent* and the unique name assigned to the file in the 
C8E catalog. The receiver should copy the file to his own catalog* 
and ttlfiQ £li&S£ £bz filfi fLfil £&£ CS£ satllaa. Note that if the 
receiver doesn't have a mailbox* he won't be informed that the file 
is there. Parameters to SEND are s 

file or f or i * 

name of the file to be sent to the remote user. 



un or to : 

User Name of the user TO whom the file is to be sent. 



at or in * 

Identifier of the site (7 characters or less) AT or IN 
which the receiver resides. 
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13.1 SEND - TRANSMIT FILES BETWEEN NOS SITES 



Example of SEND Usage 



ses.send binfile to hm00612 at sv!112 
* END SEND BINFILE -> HM00612 AT SVL 



ses.send regards to rdp at arhlOl 

* END SEND REGARDS -> RDP AT ARM 



The two examples show SEND used with all its parameters* One 
sender is assumed to be in Arden Hills (ARH101) sending to someone 
in Sunnyvale (SVL112)* and the other example shows the reverse 
s i tuat ion* 



Example of NAIL messages received from SEND 

When a remote user sends you files* you receive mail messages 
something like the following s 

ses.getmail 

* MAILBOX CONTENTS 

* 

FROM USER C8E C CYBER 18 RECEIVER I ON JAN 14» 1980 AT 12:33 PM 
FILE AS0RT»ZQ06BS2/UN»C8E FROM REF IRQDNEY FOTHERINGAY) IS AVAILABLE 

FROM USER C8E I CYBER 18 RECEIVER I ON JAN 15, 1980 AT 12*45 PM 
FILE^G0F*ZQZW8XG/UN*C8E FROM ERP (EARNEST POSTLETHWAITE) IS AVAILABLE 

♦ END GETMAXL 

Now you ATTACH the files from the C8E catalog* copy them to your 
own catalog* and finally auiaa ihfil t£fl! thfi £££ fiataiflfl (and 2l££SS 
remember the last step). 
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13,2 MAR - SEND HAIL TO OTHER USERS 



13.2 8UL™S£!ia-?!AIL-ia-aia£&.-U£E&S 

MAIL is the procedure to send mail to other users* mailbox(s) 
Parameters to MAIL are? 



i or f : 

(optional) name of Input File containing the mail to be 
transmitted to the mailboxe(s)* If you don't code the i 
parameter* HAIL takes the lessaae from file INPUT* so that 
if you»re at the terminal* it prompts for the message* 



un or to * 

list of User Names to whom the mail is to be sent TO* 

at or in : 

(optional) Identifier of the site (machine identifier! AT 
which the addressees reside* AH addressees in the list 
(if more than one) must be at the same site* If you don't 
code the at parameter* mail is sent to users on the machine 
you're running on* 



It may happen that one or more people to whom you're sending mail 
don't have a MAILBOX* In this case* if the source of mail is a 
terminal file (such as INPUT)* HAIL saves the message you so 
laboriously typed in on a unique named file* and issues a message to 
that effect* If the mail message was on a permanent file* of course 
it is left local anyway* 
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13.2 MAIL - SEND MAIL TO OTHER USERS 



Example of MAIL Usage 



ses.mail un*J303 

? Alex t 

? I*ire made the modifications to SESPRQC and 

? replaced it on SESLNAM. 

? 

* END MAIL INPUT -> 4303 



ses.mail missifs to lsherman# bob* Jim) at arhlOl 
* ENO MAIL MISSIFS *> SHERMAN.. JIM 
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13.3 GETMAIL - DISPLAY MAIL FROM MAILBOX 



13.3 ££IMAIL^-QIi£LH.HUi-FSQt!-iUUOX 

GETMAIL displays the contents of your mailbox on a file* output 
(the terminal If you're an Interactive user) by default. Parameters 
to GETMAIL are s 



o or output s 

(optional) name of file to receive the Output from 

GETMAIL. If you don*t code the o parameter* GETMAIL 

displays the mail on file OUTPUT. 



seq 



if you code this (optional) k&X* GETMAIL writes the 
contents of your mailbox with each line SEQuenced (the 
sequence number will be on the left en6 of the lines). 
This feature is useful* for example* for extracting 
information from your mailbox via the SELECT procedure 
(desribed in another section of this document). 



Example of GETMAIL Usage 



ses.getmai I 

* MAILBOX CONTENTS 
♦ 

FROM USER HN03 CValery Vitriol ix) ON NOV 4, 77 AT 4*33 PM 
San * 

New version of program no* available on the 
project program library. ••••••Val 

* END GETMAIL 
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NEWMAIL creates a new mailbox if one doesn't already exist in 

your catalog. If a mailbox already exists* NEWMAIL deletes any 

Items previously examined via GETMAIL* There are no parameters to 
NEWMAIL* you simply code : 

ses.newmai I 



Also see the introduction to the Handbook for the description of 
the BuiLO PROFife (BLDPROF) procedure* which in addition to creating 
a profile for you* creates your mailbox as part of setting up your 
initial SES environment* 
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13,5 ANYMAIL - COUNT NUMBER OF ITEMS IN MAILBOX 



13*5 &&miL-= JLQUMI JiUaa£&-Q£UI£Hi-IiLMAXUM 

ANYMAIL informs you of how many items there are in your mailbox* 
There are no parameters to ANYMAIL* you simply code s 

ses. anymai I 



Examples of ANYMAIL Usage 

ses« anyma i I 

* LETTERCS) IN MAILBOX 

* END ANYMAIL 
ses.getmail storage 

* END GETMAIL 
ses.newmai t 

♦ END NEWMAIl 
ses.anymai I 

NO MAIL TODAY 

♦ END ANYMAIL 

The example shows ANYMAIL stating that there are four letters In 
your mailbox* After doing a GETMAIL to place the mailbox contents 
on file storage* and a NEWMAIL to clear out your mailbox* the second 
call to ANYMAIL informs you that there is no mall in the mailbox* 
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WHOMAIL displays the list of users WHO have sent MAIL to your 
mailbox since the last time you did a NEWMAIL. The user name of 
each user is displayed along with the date and time that the message 
was sent. There are no parameters to WH0I1AIL. 



Example of WHOMAIL Usage 

ses.whomai I 

FROM USER AEN CAIfred E* Neumann! ON NOV 2> 79 AT 5310 PN 

FROM USER FOR ON DEC 11» 79 AT 4*32 AM 

FROM USER JEK ON 4AM Z» 80 AT 3U0 PM 

FROM USER JXH CJack Homer! ON FEB 5» 80 AT 8U5 AM 

* END WHOMAIL 

This example shows the results when there are 4 messages in your 
mailbox at the time WHOMAIL is used* If there are no messages* the 
only output from WHOMAIL is the ending message <* END WHOMAIL). 



COMPANY PRIVATE 



13-14 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES Release 17) User's Handbook REV: A8 



13.0 SES COMMUNICATIONS 
13.7 SAVMAIL - SAVE MAILBOX 



13.7 £MMIL-=.SMLJlA.ILaOS 

SAVMAIL saves your mailbox as a text record on a multirecord* 
direct access* permanent file called OLDMAIL. If there's no file 
called OLDMAIL in your catalog* SAVMAIL creates one 9 Parameters to 
SAVMAIL are: 



title or t s 

(optional) se^ten 17) character name of the text record on 
OLDMAIL to contain the current contents of your mailbox. 
If you don't code the title parameter* SAVMAIL creates a 
name beginning with the letter M and followed by the 
current date in the form mmddyy. 



Examples of SAVMAIL Usage 

ses.savmait titfe*psr421 

* END SAVMAIL MAILBOX -> OLDMAIL 

This example shows the case where it was desired that the message 
in the mailbox be saved under an identifiable name like a PSR 
number • 



ses.savmai I 

* END SAVMAIL MAILBOX -> OLOMAIL 

If this example were run on April 22* 1979* your mailbox would be 
saved as record MQ42279 on OLDMAIL. 



ttatfi 2 see the Chapter on LIBRARY MANAGEMENT* especially the 
GETMEMCS) procedure* for some words on how to handle multi record 
f I les. 
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13*0 SES COMMUNICATIONS 

13.8 CHKHAIL - CHECK YOUR HAILBGX 



1 3. 8 CUH!!AIL.=-Ca£CJi-3CQU&-tlAILfiOX 

CHKMAIL is not actually an SES procedure that you can use via a 
ses.chknail statement* rather it is an INCLUDE file. The way to use 
It is to INCLUDE it into your PROFILE* with an SES directive like 
this in your PROFILES 

\ INCLUDE *CHKHAIL». L*UNIQUE<NAHE ) * LPFN»SESLNAN. UN-SESUNAN 

This SES directive line arranges that every time you use any SES 
procedure (with the exception of the HAIL procedures)* the CHKMAIL 
segment checks your MAILBOX for messages* and if there are any* it 
issues a message to tell you to look at your mail* 
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13,9 SUft!lII-=-SUailII.A.iaa-ia-flE-£RQCESSEa-AI-A-&EISQIE-SIIE 

SUBMIT provides a method for running a job on a remote 
mainframe* A user provided job file is processed as a batch job on 
the specified mainframe* A user job for 170 mode execution is 
responsible for getting its output sent to any site other than the 
one the job runs on* This can be done by coding an SES»0ISP0SE or 
an SES*SENDPF as part of the job* If neither of these are coded* 
the output is printed at the remote site where the job is run* 

A user job for 180 mode execution t applicable to the S2 site 
onlyj automatically has its output returned and printed at the local 
site where the user originated the job* 

f or fn « 

name of file containing the job to be processed* 



at or on 5 

site-Id of the mainframe that the job is to run on* 

mode 2 

(optional) value (170 or 180) to indicate execution mode for 
the job at the remote site; default is mode»170; the mode 
parameter is applicable anil to jobs to be run on the S2 
remote site* 

You can set a default for the mode parameter by defining the 

submode variable in your profile* For instance* \SUBH0DE*18Q in the 

PROFILE submits all jobs in 180 mode unless mode*170 is coded when 
the SUBMIT proc is run* 
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13.10 SITPf^-^GET^A^PERMANENT^f l±E FRO* * *l%Qll Slit m§m _ Mtmmmmtmmm 

13.10 fiEI££.=.fi£I.A.EI&flAt!£iiI-£IL£_£EQ!l-A.a£llDI£-iIIE 

GETPF ACQUIRE's a file from a remote mainframe and wakes a copy 
of it in your catalog on the local mainframe. The copy created on 
the local mainframe is a direct access file. If the file Is not 
under your user number on the remote mainframe* you must have 
permission to access the file. Parameters to GETPF are s 

Offl J 

name of file to be acquired on the remote mainframe. 



at or on * 

site-Id of the mainframe from which the file is to be 
acqui red. 



un i 

(optional ) user number of the catalog the file is under on the 
remote mainframe. If this parameter is not coded* GETPF uses 
the user number value for this site from your PROFILE. 



nfn J 

(optional) name to be used for the copy of the file created in 
your catalog on the local mainframe. If this parameter is not 
coded* GETPF uses the value for ofn. If nfn already exists in 
your catalog* GETPF terminates with an error status. GETPF 
creates nfn as a direct access file. 



status or nostat : 

coding the (optional) status &e.y. causes a message to be placed 
In your mailbox when GETPF completes. When the nostat &£¥. Is 
coded* you aren't notified of GETPF*s completion* or whether 
It was sucessful. The default is no message upon completion. 
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SENDPF copies a file from a local mainframe to a remote 
mainf rame. If the file already exists* it is rewritten. Parameters 
for SENDPF are : 



ofn s 

name of file on the local mainframe that is to be copied to 

the remote mainframe* 



at or on : 

site-id of the remote mainframe. 



un : 

(optional) user name that the local file is cataloged under. 
If this parameter Is not coded* your user name is used. 



nfn : 

(optional) name of file to be created on the remote 
mainframe. If this parameter is not coded* SENOPF uses the 
value of ofn. If file nfn already exists on the remote 
mainframe* SENOPF writes the new file over it. SENOPF creates 
nfn as a direct access file. 



status or nostat s 

coding the (optional) status j££y. causes a message to be placed 
in your mailbox when SENDPF completes. yhen the nostat &e.x is 
coded* you aren't notified when SENDPF completes. The default 
is no message upon completion. 



COHPANY PRIVATE 



13-19 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES {Release 17) User's Handbook REV* AB 

13,0 SES COMMUNICATIONS 

13.12 CaAtiaE£-r-£iiAMS£-£AE4!l£I£aS-Q£-A^££S(3Ati£!ir-£IL£ 

CHANGPF modifies parameters of a permanent file on a remote 
mainframe without re-defining it. Parameters for CHANGPF are ? 

ofn s 

name of the fife on the remote mainframe to be changed* 

at or on : 

site-id of the remote mainframe. 



nfn s 

(optional) new name of the file on the remote mainframe* 



ct : 

(optional) new file category* Must be P (private)* S 
(semipr i vate) or PU (public). If the parameter is not coded* 
the file category is not changed* 



* : 



(optional) new access mode for the file* Must be W(write)» 
M(modify)» A(append). R(read)* RM(readmd)* RA(readap)* 
E(execute)* or N(nul i-removes permission granted by permission 
commands)* If the parameter is not coded* the access mode 
isn»t changed* 



PX 5 

(optional) new password (1 to 7 characters) for the file* If 
this parameter is not coded* the password isn't changed* 



status or nostat 5 

coding the (optional) status &£g causes a message to be placed 
in your mailbox when CHANGPF completes. When the nostat fc££ 
is coded* you aren f t notified when CHANGPF completes* The 
default is no message upon completion* 
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X 3*1 3^PURGPF^— ^REHOVE i^^^^^PERMAHeNT^FILE^^^^^^^^^^^^^^^^^^^^^^ 

13.13 £UESB£.= J*£aQ¥£a£UE££l_£_££EM&£tiI-£IL£ 

PURGPF removes a permanent file from a remote mainframe* If the 
file Is not in your own catalog* you must have write permission in 
order to purge it* Parameters for PURGPF are : 

ofn : 

name of file to be purged* 

at or on : 

the site-id of the remote mainframe* 



un s 

(optional) user name on the remote mainframe that ofn is 
cataloged under* 



status or nostat : 

coding the (optional) status Jsgy. causes a message to be placed 
In your mailbox when PURGPF completes* When the nostat j£j»y. is 
coded you aren't notified when PURGPF completes* The default 
is no message upon completion* 
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1 3 * 1 * EE£MEE_:_££EMI_A££ES$-IQ-&«EERM!i£!iI-£IU 

PERHPF explicitly permits another user to access a file in your 
catalog on a remote mainframe* Parameters to PERHPF are s 

ofn i 

name of file for *hich access is being permitted* 

at or on s 

site-id of the mainframe the file is on. 



user name to be permitted access to the file* 



m : 

(optional) permitted mode of access* If this parameter Is 
not coded* R (read) permission is used* 



status or nostat : 

coding the (optional) status fc£s causes a message to be 

Placed in your mailbox when PERHPF completes* When the 

nostat Jsfii Is coded* you aren't notified of PERMPF f s 

completion* the default is no message upon completion* 
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13.15 CATPF - DI S?|;AYS^INFORHATION^ABOUT^A w FItE^ 

13.15 £AI£E-=-QIS£LAXS.IIi£a£aAIIOtl.AaQUI-.A.£IL£ 

CATPF displays CATiist information about Permanent Files on a 
remote mainframe. Parameters to CATPF are 5 



of n i 

{optional! file name that catalog information is desired for. 



at or on s 

(required) site-id of remote mainframe to get catlist 
information from* 



un : 

(optional) user number of an alternative catalog on the remote 
mainframe* 



lo : 

(optional) list options for NOS CATLIST command. Default is 
ful I i nf ormati on (F) . 



listing or I : 

(optional) name of file on the local mainframe to receive 
listing. If this parameter is not coded* the listing is 
printed at the local mainframe central site* 



status or nostat : 

coding the (optional) status fcfiY. causes a message to be placed 
in your mailbox when CATPF completes. When the nostat &e.v. is 
coded* you aren't notified of CATPF's completion. Default is 
no message upon completion. 
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13*0 SES COMMUNICATIONS 

13.16 DISPOSE - PRINT A FILE AT A REMOTE SITE 



13,16 aiS£aSE--.£RI£iI-A-£ILE-4I-4-&£HQI£-SIIE 

DISPOSE prints a file from the local mainframe on a printer at 
the remote mainframe* Parameters to DISPOSE are ? 



file or f s 

name of file to be printed* 



at or on s 

site-id of remote mainframe where file is printed* 



print or p : 

(optional) string containing parameters to control the action 
of the SES PRINT procedure which is used to print the file at 
the remote site* If you don't code the print parameter* 
DISPOSE prints one copy of the file at the remote site* For 
a complete description of the values that may be coded for 
the print parameter* see the description of the procedure 
PRINT in the SES USERS HANDBOOK* 
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13.0 SES COMMUNICATIONS 

13.16 DISPOSE - PRINT A FILE AT A REMOTE SITE 



Non-bracketed parameters are required* 

CATPF Cofn3» at* Cun3* Clo3# Misting!* Cstatusl 

CHANGPF ofn. at» Cnfn]. Cct3* Cm3* Cpwlt CstatusJ 

DISPOSE file* at* tprintl 

GETPF ofn* at* Cun3* Cnfn3> Cstatus3 

PERMPF ofn* at* un> Cm3* tstatusl 

PURGPF ofn. at* tun3> Cstatus3 

SENDPF ofn* at* Cun3* Cfnf3* Cstatus3 

SUBMIT f* at* Cmode] 
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i*.o iExi-ttAai£ULman-Ana.£QamsiQa.uiiLiii£$ 



This section describes a list of facilities to perform general 
massaging of text files* character set conversion and so on. The 
facilities to be described are s 

EOT run the EOT text editor on a file 

LOWTOUP convert lower case letters to upper case 

UPTQLQW convert upper case letters to lower case 

CGPYACR copy ASCII coded record 

ASORT sort ASCII files 

UNIQUE removes adjacent duplicate lines from a text file 

MERGE merge up to five files on a columnar basis 

DEMERGE split a file into one to five files on a columnar basis 

COMPARE compare two text files and produce a listing of the 
differences between them 

COUNT counts characters* words* or lines in a text file 

SELECT extracts (displays) selected lines and/or ranges of lines 
from a text file 

MULTED MULTI record file EDIT facility. 
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PACK "Packs** a multi record or multi file file into a single 
text record* with control characters such that it can be 
••unpacked** again. 

UNPACK "Unpacks*** that is* reverses the action of PACK. 

CONV CQNVert the character set of a text file 

JABFGRM convert source for the TEXTJAB document formatter to source 
for the TXTFQRM document formatter 

SNOBOL 8-bit SNOBOL interpreter. 

FIND search a file for specified text patterns. 

CHANGE change matched text lines in a file. 

XLIT transliterate characters In a file 
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i4, i £Qi.=.auii.iid£-£Qi-i£^i.£aiiQa 

EOT runs the EOT text editor for you. EOT is an enhanced version 
of the standard NQS text editor* A description of EOT can be found 
in an appendix to this document* This EOT procedure is mainly 
intended to work in conjunction with procedures such as GETMQDCS)* 
GETHEM(S)* PACK* UNPACK and so on* so that you can* for instance* 
string a bunch of procedures together* like ? 

ses*getmod m»nurdle; edt; repnod 

to get a module off a base* edit it and replace it all in one 
procedure line* Parameters to EOT are s 

i or f : 

(optional) name of Input File containing text to be 
EDiTed* If you don't code the i parameter* EOT uses the 
value of profile variable group as the name of the input 
file* and if there's no such variable defined* EOT uses a 
default file name of group* 

ec or Input t 

Coptional) name of file containing Edit Commands to EDT* 
If you don't code the ec parameter* EOT uses file input* 

eo or output * 

(optional) name of file to receive Edit Output* If you 
don't code the eo parameter* EOT uses file output* 

t or tabs ? 

(optional) TABS parameter for EOT* If you don't code the 
t parameter* there are no tabs set* You may set up a 
default tabs name in your profile by defining the tabs 
var i abl e* 



save or rep * 

if you code this (optional) key.* EDT REPIaces the file 
specified by the i parameter in your catalog when you've 
finished editing* If you don't code the rep Itfiy.* the file 
i s I eft 1 ocal • 
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14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
14.2 LOWTOUP - CONVERT LOWER CASE TO UPPER CASE 



14.2 LQMIOUE-=-CQlimi-LQiiER-CASE-IQ-UEEE&-£ASE 

LOWTOUP converts all LOWer case letters in a text file to UPper 
case letters. Parameters for LOWTOUP are 5 



I or f s 



name of Input File containing text to be processed by 
LOWTOUP. 



(optional) name of file to receive the Output from 
LOWTOUP. If you don't code the o parameter* the output 
appears on the file specified by the I parameter. 



Example of LOWTOUP Usage 

ses.lotftoup i*lotfcase# o*upcase 

* END LOWTOUP LOWCASE -> UPCASE 

This example shows LOWTOUP converting all lower case letters in a 
file called lowcase into upper case letters* and produce the output 
on a file called upcase. 
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UPTOLQy converts ail UPper case letters in a text file to LOWer 
case* Parameters for UPTOLQtf are i 

i or f s 

name of Input File containing text to be processed by 
UPTQLOW. 



O 3 



(optional) name of file to receive the Output from 
UPTOLOVJ. If you don f t code the o parameter? the output 
appears on the file specified by the i parameter. 



Example of UPTOLOW Usage 

ses.uptolow i*upper> o»lower 

* END UPTOLGW UPPER -> LOWER 

This example shows UPTOLOW converting all upper case letters in a 
file called upper to lower case letters* and producing the output on 
a file called lower. 



COMPANY PRIVATE 



14-6 

COC - SOFTWARE ENGINEERING SERVICES 

7/30/8 

14,0 TEXT MANIPULATION AND CONVERSION UTILITIES 

14.4 £QEXACa-=-Cfl£I-ASUI-COQ£Q.&E£QEQiSl 

CQPYACR stands for COPY ASCII Coded Recordist and as its name 

implies* it is the ASCII equivalent to the standard NOS CGPYCR 

utility. This CQPYACR procedure does a bit more than the standard 

NOS COPYCR s it acquires the input file for you* and rewrites the 

output fife back over the input file if you specify it that way. 

CQPYACR can also perform some character set conversions for you (see 
below). Parameters to CQPYACR are ? 



i or f 



name of Input File containing text to be processed by 
CQPYACR. 



(optional) name of file to receive the Output from 
CQPYACR. If you don't code the o parameter* the output 
appears on the file specified by the i parameter. 

cols or c s 

{optional) specification of the CQLumnS between which the 
file is to be copied. The c parameter must be coded as a 
range* or in the form tow..high» where low is the left 
column at which to start copying* and high is the right 
column beyond which the file is not to be copied* If you 
don«t code the c parameter* CQPYACR uses the range 1..80 
for the copy. 

incset or ic : 

(optional) designator for the IMput file's Character SET. 
The table below describes the allowed designators. 

outcset or oc * 

(optional) designator for the OUTput file»s Character 
SET. The table below describes the allowed designators. 

Both the incset and outcset parameters default to c.s.612 (see 
below) but this can be over-ridden by defining in your profile 
defaults via variables with names the same as the parameters. The 
following table defines the allowed designators for the incset and 
outcset parameters s 
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14,0 TEXT MANIPULATION AND CONVERSION UTILITIES 
14*4 COPYACR - CORY ASCII CODED RECQRD(S) 



* * 

• * 
« * 


* • 

* * 

J cs612 S NOS 6/12 ASCII character set 

* * 

* * 

« • 

* cs64 ' 64 character ASCII subset (display code) 

* ? character set 

* * 


t * 

* * 

1 cs812 5 "8 out of 12 w ASCII character set 

• t 



Example of COPYACR Usage 



ses.copyacr grab hold 11. .17 
* END COPYACR GRAB -> HOLD 

This example shows COPYACR copying file grab between columns 11 
thru 17 inclusive* and placing the result of the copy on file hold* 
You might wonder what«s the use of doing that? Well the NOS CATALOG 
utility outputs the record names starting in column 11* so you could 
use this example of COPYACR to isolate all the record names. 
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ASQRT is a utility to sort ASCII files according to sets of sort 
directives* Parameters to ASORT are s 



i or f s 



name of Input File to be processed by ASORT* 



(optional) name of file to receive the Output from ASORT* 
If you don't code the o parameter* ASORT places the output 
file on the file specified by the i parameter* 

keys t 

list of sort KEYS to direct the sort process* Each 
element in the list of keys consists of three items* The 
first item is the start column of the field* the second 
item is the (optional) length of the field (default 1 
character)* and the third item is the (optional) sort 
order* A for Ascending* and for Descending* The default 
is Ascending order. There is an example of ASORT at the 
enti of this description* 

retain : 

this (optional) &£X is the SORT/MERGE RETAIN option. If 
you don't code the retain &£*• SORT/MERGE outputs 
identically keyed records in arbitrary order* If you do 
code the retain &£** such records are output in their 
original order* 

Hatfi : the collating sequence for ASORT is the ASCII collating 
sequence* Upper and lo*er case letters are considered identical for 
the sort process* so that alphabetic items aren't separated by an 
entire case of the alphabet* 
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Example of ASORT Usage 

ses.asort i»shuffld* o*orderly# keys*! CI* 71* (10>7*d)* (21*41 I 
* END ASORT SHUFFLD -> ORDERLY 

This example shows ASORT sorting the file shuffld onto the file 
orderly* The keys used are column 1 for a length of seven 
characters* in ascending order (since that's the default)* column 10 
for a length of seven characters in descending order* and column 21 
for a length of four characters* in ascending order (again 
def aul ted) • 

ses.asort i*higgldy» oMInedup* keys»f<14* 3» dll 

* END ASORT HIGGLDY -> LINEDUP 

This example of ASORT highlights one of the minor inconveniences of 
parameters that are lists of lists* namely* that even »hen you f ve 
only got one key to sort on* you still need double parentheses* The 
following discussion explains the keys parameter* 

The keys parameter is a list of sort keys, each sifiisat of that 
list is itself a list of up to three elements* So at the top level 
you get this situation : 

keys*(key.l» key. 2* key.3»***« key.nl 

each key.i is itself a list of one to three elements J 

(start.col umn* key. length* sort. direction) 

start. column is the column position of the start of the sort key. 

key.length is the number of characters in the key* inclusive of 
start. column ■ - the default key.length is 1. 

sort. direction is a single letter indicator 5 A for Ascending order 
(the default)* for Descending order* 

So let*s look at some real live examples of sort keys « 

keys*f(4* 2« d)» (lit 7* dl) 

is a list for £ms sort keys* the first starts in column 4* is 2 
characters long* and is sorting in descending order? the second 
starts In column 11* Is 7 characters long* and is also sorting in 
descending order* Here's the iias list* but this time the sort 
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order is ascending* so you can leave out the direction indicators * 

keys«U4* 21* (11* 71) 

Now let's look at some more default cases; suppose the column 4 key 
is only aaa character long - now you can write the keys like this J 

keys*U4» II* (11* 71! 

but the key_length of one is the default* so it can be written 5 

keys*U4l* (11* 711 

harking way back to chapter 1 and the section called "lists of 
values for parameters 1 ** recall that a single element list doesn't 
nee4 the parentheses * 

keys(4* (11* 7)1 

Now let's shorten it still further by reducing the seven character 
field to one : 

keys»(4* 111 

Getting down to the minimum case of a single key of length one in 
ascending order* you get s 

keys«4* keys«((4* 111 and keys*<(4* 1* a)) are all identical* 
whereas : 

keys«(7» 121 means keys«(C7* 11* 112* II) 
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UNIQUE removes adjacent duplicate fines from a text file* Such a 
situation usually arises when a file has been sorted* fas for 
example with the ASORT procedure previously described) and duplicate 
lines in the file are all together. UNIQUE provides the capability 
of reducing the file to one instance of each unique line. For 
example* UNIQUE acts as follows : 

Input File Output File 

Just the place for a Snark Just the place for a Snark 

the Bellman Cried the Bellman cried 

the Bellman cried as he landed his crew with care 

as he landed his crew with care supporting each one 

supporting each one on the top of the tide 

on the top of the tide with a finger entwined in his hair 

on the top of the tide 

on the top of the tide 

with a finger entwined in his hair 

yith that example to show how it works* the parameters to UNIQUE 
are s 

i or f s 

name of the Input £ile containing the text which is to have 
the adjacent duplicate lines removed. 



is the (optional) name of the Qutput file from the UNIQUE 
process. If you don f t code the o parameter* the results 
appear on the f i I e speci f i ed by the I parameter. 
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14.6 UNIQUE - REMOVE ADJACENT DUPLICATE LINES FROM A FILE 



Examples of UNIQUE Usage* 



ses.unique i*sorted« ©^removed 

* END UNIQUE SORTED -> REMOVED 



ses.unique duplies 

* END UNIQUE DUPLICS 
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MERGE combines up to five files on a columnar basis. Parameters 
to HERGE are ? 



o : 



name of file to receive the Output of MERGE 



m or merge : 

a list of up to five column widths specifying how the 
input files are to be MERGEd into the output file (see the 
example below}* 



i or f 



(optional) list of up to five Input Files to be MERGEd 
onto the file specified by the o parameter. If you don't 
code values for the i parameter* MERGE uses filenames 
tapel thru tape5 for its input files* 



Example of MERGE Usage 

ses.merge o*diagram» m=( 21«21> 21 ) • i*(columnl. column2* column3) 
* END MERGE C0LUMN1»CQLUMN2#C0LUMN3 -> DIAGRAM 

In this example* MERGE is constructing a file called diagram* by 
merging together the three files columnl* column2» and column3. The 
contents of file columnl occupy the first 21 columns in the diagram 
file* the contents of file column? occupy columns 22 thru 42 in the 
diagram file* and the contents of file coiumn3 occupy columns 43 
thru 63 In the diagram file. 
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14,8 a£a£a££.::-miI-EILE-A£&ai_aX-CQLlMfcia 

DEMERGE splits a file into one to five files on a columnar 
basis* Parameters to DEMERGE are 5 



I or f i 

name of Input File which is to be DEMERGEd. 



d or demerge t 

a list of up to five column widths specifying how the 
input file is to be DEMERGEd into the output files Csee 
the example below)* 



o : 



(optional) list of up to five files to receive the Output 
of DEMERGE* If you don*t code values for the o parameter* 
DEMERGE uses tapel thru tape5. 



Example of DEMERGE Usage 

ses. demerge i*compile. d*(81>23)> oMsource* numbers) 
* END DEMERGE COMPILE -> SOURCE* NUMBERS 

This example shows DEMERGE splitting up a file called compile 
into two components* In this example {taken from real life)* the 
first 81 columns of compile are the source statements from a master 
audit of a deck in an UPDATE PL* and the last 23 columns are the 
statement numbers. The two separate sets of data appear in the 
example on files source and numbers* 
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The COMPARE procedure compares two text files and produces a 
•Misting** of the differences between them in terms of inserted* 
deleted* and replaced lines. Parameters to COMPARE are * 



new 



old 



this (optional) parameter specifies the name of the file 
containing the "new" version of the text. If you don*t 
code this parameter? COMPARE uses a file called new. 



this (optional) parameter specifies the name of the file 
containing the w old M version of the text. If you don*t 
code this parameter* COMPARE uses a file called old* 



this (optional) parameter specifies the name of the fife to 
receive the output from COMPARE. If you don f t code this 
parameter* COMPARE writes the results of the comparison to 
file output. Note that if the two files are equivalent* 
COMPARE doesn*t write anything to the o file. 



newcset : 

(optional) designator for the NEW file*s Character SET. 
The table below describes the allowed designators. 

oldcset 5 

(optional) designator for the OLD file's Character SET. 
The table below describes the allowed designators. 



outcset : 

(optional) designator for the OUTput file»s Character 
SET. The table below describes the allowed designators. 



Is or ignorls t 

these (optional) &£££ specify whether or not to ISMttfiL® 
Leading Spaces on lines being compared* The default action 
is to recognise leading spaces (the is option). If you 
code the ignorls jifii* COMPARE ignores leading spaces on 
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14,9 COMPARE - COHPARE TEXT FILES 



text Tines. 



The default character set designator for all three cset 
parameters Is &£&!£* The following table defines the allowed 
designators for the cset parameters s 



4 * 

i * 

+ , , 4. , . , , + 

1 * 

cs612 5 HOS 6/12 ASCII character set J 



cs64 * 64 character ASCII subset (display code) 
J character set 



cs812 \ "8 out of 12" ASCII character set J 

1 * 
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14.10 CQy!iI-=-CQiJ!llI-iaitiSa-Iti.^£IL£ 

COUNT counts one of the following three things In a file : 

characters number of ASCII characters In a file* 

lines number of lines* 

words number of words in a file* where a w word w is defined as a 
contiguous set of characters delimited by spacets)* 
tabCs) or newlineCs). 

Parameters to the COUNT procedure are 2 

c or chars or I or lines or w or words * 

these Mais define which thing is to be counted {Characters* 
Lines or jjords). 

I or f or In ? 

name of Input £ile Ifci which the things are to be counted. 

o or to * 

is the (optional) name of the Output file IQ which the 
results of the counting process are to go. If you don't 
code the to parameter* the results go to file output. 



Examples of COUNT Usage 

ses. count lines In source 
7396 

* END COUNT SOURCE 

ses. count words in guide to results 

* END COUNT GUIDE -> RESULTS 

The first example shows COUNT counting the number of lines in a 
file called source* with the result going to file output by 
default. The second example counts the number of words in a file 

COMPANY PRIVATE 



14-18 
COC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User's Handbook REV: AB 

14,0 TEXT MANIPULATION AND CONVERSION UTILITIES 

called guide* with the answer written to a fife called results* 
Note that the choice of parameter keywords weans we can specify the 
COUNT process in a more "English** form* 



COHPANY PRIVATE 



14-19 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 171 User*s Handbook REV* AB 

14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 

14.11 S£L£ai.=«CQ£X.S£U£I£2-LIM.E4ME£^£aQB-4«£IL£ 

SELECT copies selected lines or ranges of lines from one file to 
another* The default output file used by SELECT is In fact file 
output* so that the utility provides an easy way to look at selected 
parts of a file without needing to edit the fife. Parameters to the 
SELECT procedure are s 

line or lines : 

Is a list of line numbers or line number ranges to be 
selected from the input file. 



I or f or of s 

is the name of the Input £ile from which the lines or 
ranges of lines are to selected. 



o or to s 

is the (optional) name of the Qutput file IQ which the 
selected lines are to be copied. If you don»t code the to 
parameter* the selected lines go to file output by 
default. You can code the output file name to be the same 
as the Input file name in which case the input file gets 
overwritten by the selected lines. 



Examples of SELECT Usage 



ses.select line 50 of somfile 

Beware the frumious Bandersnatch my son* 

* END SELECT SOMFILE 



ses.select lines 10. .19 of nurdle to twisted 
* END SELECT NURDLE -> TWISTED 



ses.select lines f 5>7»9..17#19»23..47) of primes to sifted 
* END SELECT PRIMES -> SIFTED 



The three examples shown above should give a good idea of the way 
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14.11 SELECT - COPY SELECTED LINE RANGES FROM A FILE 



that SELECT is used* showing a single line* 
finally a list of lines and line ranges* 
ranges are diagnosed* Line ranges in which 
range is larger than the number of lines in 
selction to go to the end of the input file. 



a range of lines* and 

Invalid line numbers and 

the high en4 of the 

the input file cause the 
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MULTED provides the ability (not provided by the NOS text editor) 
to edit a multi record file. This is especially useful for 
instance* where major and global changes must be made to many decks 
of a source text program library. It is easy to generate a SOURCE 
filet MULTED that file* then replace the decks on the PL. MULTED 
uses the PACK and UNPACK procedures to change the multi record file 
to a single record file ready for editing* and to reverse the 
process when editing is complete* MULTED invokes the EOT text 
editor* an enhanced version of the standard NOS text editor* A 
description of EOT can be found in an appendix to this document* 
Parameters to MULTED are* 



I or f 



name of File containing MULTED input* 



(optional) name of file to receive the Output from 
MULTED* If you don't code the o parameter* the output 
appears on the file specified by the I parameter* 

ec or Input s 

(optional) name of file containing Edit Commands to be 
used by EOT* If you don't code the ec parameter* MULTED 
assumes that the edit commands are coming from file 
INPUT. 



eo or output * 

(optional) name of file to receive Edit Output* If you 
don't code the eo parameter* HULTED assumes that the 
output is going to file OUTPUT* 



t or tabs s 

(optional) TABS parameter for EOT. If you don't code the 
t parameter* MULTED doesn f t set any tabs* You may set up 
a default tabs name In your profile by defining the tabs 
var i able* 



cc 



(optional) Control Character to be used for the 
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14.12 HULTED - EDIT HULTI RECORD FILE 



PACK-UNPACK process* If you don't code the cc parameter* 
HULTED uses a control character of slash (/)* 



save or rep s 

if you code this (optional* &gi* HULTED REPIaces the file 
when editing Is complete. If you don't code either of 
these keys* HULTED leaves the file local* 



Example of using HULTED* 

ses.multed rigor* mortice* cc« , ? f 

This example PACKs file rigor* invokes EDT to edit the PACKed 
file, and finally UNPACKS the file onto file mortice* The PACK 
process turns all physical I EOR's and EOF's into the character 
strings ?E0R and ?E0F respectively* and the UNPACK process reverses 
the operation* 
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RACK packs a multi record file into a single record in such a way 

that the record structure is maintained* and may be reconstituted by 

a subsequent UNPACK. It is a useful facility vihen you want to edit 

a multl record text file for instance* Parameters to PACK ares 

I or f ? 

(optional) name of Input File to be PACKed* If you don't 
code the i parameter* PACK uses the name associated with 
profile variable group* If there isn't such a profile 
variable defined* PACK uses a filename of group* 



(optional) name of file to receive the Output from PACK. 
If you omit this parameter* the output appears on the file 
specified by the I parameter* 



cc 



(optional) Control Character to be used for the PACK 
process* If you don't code the cc parameter* PACK uses a 
control character of slash (/)• 



Example of PACK Usage 



ses.pack i«multrec» o*packed> cc'! 1 
* END PACK MULTREC -> PACKED 



This example shows PACK being used to "pack" a multi record file 

called multrec and produce the output of the process on a file 

called packed* The control character ! is used* so that every 

physical EOR in the file is replaced by the character string IE0R In 



the output* 
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UNPACK provides the converse operation to that provided by PACK* 
or it unpacks a single record text file into a mu i t I record fife* 
Parameters to UNPACK are? 



i or f 



cc 



(optional) name of Input File containing data to be 
processed by UNPACK. If you don't code the i parameter* 
UNPACK uses the name associated with profiie variable 
group* If there isn't such a profile variable defined* 
UNPACK uses a fife name of group* 



(optional) name of file to receive the Output from 
UNPACK* If you don't code the o parameter* the output 
appears on the file specified by the i parameter* 



(optional) Control Character to be used for the UNPACK 
process* If you don't code the cc parameter* UNPACK uses 
a control character of slash (/)» 



Example of UNPACK Usage 

ses. unpack l*packed» o*unpackd* cc* 4 !* 
* END UNPACK PACKED -> UNPACKD 

This example shows UNPACK being used to reverse the w pack w 
process described in the previous section* The file packed Is 
•unpacked 1 onto the file unpackd. The control character of t is 
used so that every line that has a IE0R starting in column one is 
replaced with a physical end of record in the output file* 
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CONV converts text files from one character set to another. NOTE * 
- Due to its flexibility* the conversion process is fairly time * 
consuming. Parameters to CONV are * J 

I or f * 

name of the Input File containg text to be converted. 

o : 

(optional) name of the file to receive the Output from 
CQNV* If you don't code the o parameter* the output 
appears on the file specified by the i parameter* 

incset or lc s 

designator for the INput file's Character SET. See the 
table below for a description of the allowed designators* 

outcset or oc 2 

designator for the OUTput file's Character SET* See the 
table below for a description of the allowed designators* 

The following table defines the designators allowed for the 
incset and outcset parameters? 

N63 NOS 63 6-bit codes 

N64 NOS 64 6-bit codes 

N612 NOS 6/12 ASCII 6-bit and 12-bit codes 

N612U same as N612 except that all letters are upper 

case 

N612L same as N612 except that all letters are lower 

case 

NBE63 NOS/BE 63 6-bit codes 
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14.15 CQNV - CONVERT CHARACTER SET 



NBE64 
NBE63A 

N8E64A 

ASCII4 
ASCII5 



NOS/BE 64 6-bit codes 

NDS/8E ASCII 63 character subset 7-bit codes C5 
per word) 

NOS/BE ASCII 64 character subset 7-bit codes (5 
per word) 

full ASCII 7-bit codes <4 per word) 

full ASCII 7-bit codes (5 per word) 



A table of these characters sets can be found in an appendix to 
this document. 
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14,16 lAS£QEJ3.=-£QMM£SI.I£XIi4a^QyECE.IQ-IXI£Q£S-SQyB££ 

4A8FQRM converts source for the TEXTJA8 document formatter to I 

source for the TXTFORM document formatter. JABFORM only works on I 

TEXTJAB source format directives that are delimited. Parameters to $ 
JABFQRM are ? 



I or f s 



name of the Input File containing the TEXTJAB document 
source. 



name of the file on which the TXTFORN source is written 
Out* &a£s that unlike many other SES procedures JABFGRM 
doesn't overwrite the Input file with the Output file* 



(optional) name of the file to receive error messages from 
JA8FQRM* If you don f t code the e parameter* JABFORM uses 
file ERRLIST. 



A complete description of the conversions performed by JABFGRM 
can be found in an appendix to this document* 



e : 
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mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm m mm mmmmmmmmmmmmmmmmmmmmmmmmmmmm 

14.17 SJiQaQL.z.a=aiI.SMaaOUIHI£E£a£IE£ 

SNQBOL is an 8-bit version of the SN0B0L4 interpreter. SNOBOL 
afftcionados will realise that SNOBOL requires both program and data 
on the same input file; using the SES SNOBOL procedure you can (if 
you want) have the program and data on separate files* in which case 
SES gathers them onto the same file before running SNOBOL. The 
SNOBOL interpreter requires its input in 8-12 ASCII and produces its 
output in the same character set. Parameters are t 

i or f s 

name of Input File containing the SNOBOL source program* 
and* if you wish* data for the program. You can also 
specify a data file with the d parameter. 

Jt or data ' 

is the (optional) name of a Qata file for the SNOBOL 

program. If you do code this parameter* the data file is 

appended to the input file specified by the i parameter. 



(optional) name of file to receive the Qutput of the SNOBOL 
run. If you don't code the o parameter* the output appears 
on the file specified by the i parameter. 
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14.18 £iBa-=-£IB2-£4II£ES£-I&LA.£IL£ 

FIND searches a file line by line* looking for specific text 
aafctfiLQS or CSaulat £XfiL£££i2DS. There is a discussion on regular 
expressions later. The pattern to be located in the file may be 
specified on the SES control statement* or* if there are lower case 
characters which can't be represented* an argument file {default 
Input) may be supplied* Parameters to FIND are J 

P or pattern or with or using : 

(ootional) pattern specification. If you don't code this 
parameter at all* FIND takes its argument pattern from file 
Input* and prompts you accordingly. The p or pattern 
keywords or no keyword indicate that the pattern is right 
there on the SES control statement. The with or using 
keywords indicate that the pattern is in an argument file 
which is specified as the value of the parameter. 

i or in or f J 

is the name of the Input £ile 1$ which the regular 
expressions are to be located. 

o or onto s 

(optional) name of the file Q8IQ which the Qutput of FIND 

is to appear. If you don't code the o parameter* the 

output appears on the file specified by the i parameter. 
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14.18 FIND - FIND PATTERNS IN A FILE 



Examples of FIND Usage 



ses.find «C0-9J$ f in myfite onto output 
* END FIND NYFILE -> OUTPUT 



ses.find using patfile in oldfile onto foundit 
* END FIND OLDFILE -> FOUNDIT 



ses.find *#.*#' in compile 
* END FIND COMPILE 

The first example shows FIND locating all lines in myfile that 
have a digit at the end of the line. The result appears on file 
output. The second example shows FIND used with a pattern file 
patfile* The third example is locating all lines that contain a •#• 
sign followed by a run of any characters followed by another *#» 
sign. Such lines are reasonable candidates for being SYNPL comment 
I ines. 



This discussion introduces the notation for regular expressions 
used by FIND and the CHANGE procedure in the next section. The 
notation is terse but versatile* and has been applied in a number of 
pattern matching utilities. 

A t&XJt gattfiCQ can be a simple thing* like the letter a or a 
more elaborate construct built up from simple things* like the 
string format. To build arbitrary text patterns you need only know 
a few rules. 

Any litfttal £ba£A&t££* such as a* is a text pattern that matches 
that same character in the text being scanned. A sequence of 
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literal characters like 7926 or grabbold is a pattern that 
matches any occurrence of that sequence of characters in a line of 
the input. 

A pattern is said to fflatfitj part of a text line if the text line 
contains an occurrence of the pattern. For instance the pattern aa 
matches the line aabc once at position 1* the line aabcaabc in 
two places* and the line aaaa in three {overlapping) places. 
Matching is done on a line by line basis : no pattern can match 
across a line boundary. Text patterns may be CQQCalfiQatSd 5 a text 
pattern followed by another text pattern forms a new pattern that 
matches anything matched by the first* followed immediately by 
anything matched by the second. A sequence of literal characters is 
an example of concatenated patterns. 

find has other capabilities - the ability to search for patterns 
that match classes, of characters* that match patterns only at 
particular positions on a line* or that match text of indefinite 
I ength. 

To be able to express these more general patterns* we have to 
preempt some characters to represent other types of text patterns* 
or to delimit them. For example* we use the character • as a 
text pattern that matches aQJi single character except a newline. 
The pattern x.y matches x*y* xay* x?y and similar strings. 

The • and other reserved characters are often called 
fflfitacbacactSLS* We try to choose characters which won»t appear with 
high frequency in normal text* but still there are occasions when we 
want to look for a literal occurrence of a metacharacter* Thus the 
special meaning of a metacharacter may be turned off by preceding it 
with the £S£a&£ character 9. Thus 3* matches a literal period* 
and 93 matches a literal at sign. 



The metacharacter C signals that the characters following* up 
to the next J form a fibaLactSL Class* that is* a text pattern that 




Two other metacharacters don't match literal characters but 
rather match positions on the input line. A matches the JtSfliQfiiflil 
of a line s *abc is a pattern that matches abc sols If it appears 
as the first three characters of an input line. Similarly* 
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$ matches the newline at the end of a line s abc$ 
matches abc only if it is the last thing on a line before the 
newline* Of course these can work together s *abc$ matches a line 
that contains flail abc* and *$ matches only empty lines (lines 
containing only a newline)* 

Any of the text patterns above that match a single character 
(everything but * and $) can be followed by the character * to 
make a text pattern which matches Z&LQ. flL !2L£ successive 
occurrences of the single character pattern. The resulting pattern 
is called a £lfl£Ut£. For example* a* matches zero or 
more a f s* aa* matches o.qs or more a f sj Ca-zJ* matches any 
string of zero or more lower case letters* 

Since a closure matches zero or more instances of the pattern* 
which do we pick if there's a choice? It turns out to be most 
convenient to match the lflflflssfc possible string even when a null 
string match would be equally valid* Thus ta-zA-Zl* matches an 
entire word (which may be a null string)* Ca-zA^-Z Ha-zA-ZI* matches 
an entire word (one or more letters but not a null string)* 
and •* matches a whole line (which may be a null string). Any 
ambiguity in deciding which part of a line matches a pattern Is 
resolved by choosing the match beginning with the JLflftlflSt 
character* then choosing the lo.Qfle.st possible match at that point* 
So Ca-zHa-zO-91* matches the leftmost FORTRAN identifier on a 
line* (•*) matches anything between parentheses* and ••* matches 
an entire line of one or more characters (but not a line containing 
only a newl i ne ) • 

Finally* no pattern matches across a line boundary* This is 
often most natural and useful* and it prevents an unwise • * from 
eating up an whole file* 
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14.0 TEXT HANIPULATION AND CONVERSION UTILITIES 
14,18 FIND - FIND PATTERNS IN A FILE 



£uiia£¥-a£-.££auia£-£xa££saiaas 

The previous discussion introduced a lot of new notation for 
matching text patterns and regular expressions* Here is a summary 
of what went before. 

c JLiJiSCal ££*££&£££ < for example s ) 

* aa& £Jia£a££££ except newllne 

* iuaiaaiaa a£ IIds 

* £Qi 2i liO£ C null string before the newline ) 

£•••1 £tia£a££££ £l&&& t any one of these characters )• for 
example* Cijklmn] matches the first character of a Fortran 
integer identifier* 

€"•••1 asaatfid £&£££££££ £lass I a 1 I but these characters) 

* £las.ii££ Czero or wore occurrence of previous pattern) 
9c SSfiaaSd £&£££££££ <for example* 9% 9$* 9t* 9*) 

Any special meaning of characters in a text pattern is lost when 
escaped* inside a [•••] * or for s 

* not at beginning 
$ not at end 

* at beginning 

A character class consists of zero or more of the following 
elements* surrounded by £ and 1 s 

c literal character* including t 

a-c range of characters (digits* lower or upper case letters) 

* negated character class if at beginning 
3c escaped character ( 9" 9- 99 9] ) 
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Special meaning of characters in a character class is lost when 
escaped or for s 

not at beginning I for example Ca"9jug3 ) 

- at beginning or end* for example I-*sz3 or £+»abc-l 

liatfi 2 the following three safcstifctttiflO £3i£££QS apply to the 
CHANGE utility described in the next section* A £yfcs.£i£y£iaa 
Batt££Q consists of zero or more of the following elements s 

c I i ter al character 

£ ditto* that is» whatever was matched 

c escaped character ( 9€ ) 

An £&£&&£ S£3U£Q££ consists of the character 3 followed by a 
single character i 

9n newt i ne 

3t tab 

9c c { including S ) 
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CHANGE changes patterns in a file. The from and to patterns may 
be specified on the control statement* or they may be given as the 
first two lines of an argument file* Both from and to must be 
specified* at a pattern file may be given via the with or using 
parameter* If none of these parameters are supplied* CHANGE takes 
its pattern argument from file input* Parameters to CHANGE are 5 

i or f s 

name of Input £ile which is to have its patterns changed. 



from s 



tO 5 



(optional) character string which represents the from string 
to be matched. 



(optional) character string which represents the to 
substitution string. 



with or using : 

(optional) name of a file containing the from and to 
patterns on two separate lines. This file is used if there 
are lower case patterns in the from or to parameters which 
can*t be entered via the control statement* 

onto or o s 

(optional) name of file to receive the Qutput from CHANGE. 
If you don't code the o parameter* the output appears on 
the file specified by the i parameter* 



Examples of CHANGE Usage 



ses.change myfile from «*C0-5J* f to «»HARK»£« onto outfile 
* END CHANGE HYFILE -> OUTFILE 
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ses. change oldfile using patflle 
* END CHANGE OLDFILE 

The first example shows CHANGE locating all lines that have an 
arbitrary nunber of digits between and 5 at the beginning of the 
line* and changing the pattern so found into the string **MARK»* 
followed by the string of digits that was found. The second example 
shows CHANGE operating on a file* where the pattern arguments are 
supplied via the argument file patflle. 
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XLIT transliterates characters in a file* The from and to 
patterns may be specified on the control statement* or they may be 
given as the first two fines of an argument file* Both from and to 
must be specified* ox a pattern f M e may be given via the with or 
using parameter. If none of these parameters are supplied XLIT 
takes its pattern argument from file input* Parameters to XLIT 
are : 



I or f : 

name of Input £ i I e which is to have Its characters 
trans I iterated* 



from i 



to s 



(optional) character string which represents the from string 
to be transliterated* 



(optional) character string which represents the to 
transliteration string* 



with or using s 

(optional) name of a file containing the from and to 
patterns on two separate lines* This file is used if there 
are lower case characters in the from or to parameters 
which can't be entered via the control statement* 



onto or o * 

(optional) name of file to receive the Output from XLIT* 

If you don't code the o parameter* the output appears on 

the file specified by the I parameter* 



Examples of XLIT Usage 



ses.xl it rayf lie from •ABCDE 1 to »VWXYZ« onto outfife 
* END XLIT NYFILE -> OUTFILE 
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14,20 XLIT - TRANSLITERATE CHARACTERS 



ses.xlit oldfile using patfile 
* END XLIT OLDFILE 



This is a short summary of the facilities provided by XLIT. The 
examples below just show the from and to patterns* The simplest 
form of XLIT is to simply convert one character to another* like s 

from x to y 

and have all occurrences of x in the input file be replaced 
by y in the output file* Multiple translations are also handy : 

from xy to yx 

changes all x's into y*s and all y« s into x»s* There is also 
a nice shorthand notation 

from a-z to A-Z 
to translate all lower case letters to upper case* or 

from a-zA-Z to A-Za-z 
to do case reversal. Even good typists prefer 

A-Z a-z 

to 

ABCDEFGHIJKLMMOPQRSTUVWXYZ abcdef gh i jkl mnopqrstuvwxyz 

There are times when we would like to translate a whole class of 
characters into just one character* and then to collapse runs of 
that translation into just one instance* For example* translating 
spaces* tabs and newlines Into newlines and then collapsing multiple 
newtines leaves each of the words in a document on a separate line* 
ready for further processing* Or we might want to convert all 
alphabetic symbols in a program into a»s and all numbers 
into n , s« We specify this collapsing operation by giving a second 
argument that is shorter than the first : 
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14.20 XLIT - TRANSLITERATE CHARACTERS 



from a-zA-Z to a 
from 0-9 to n 

The implication is that the last character in the second argument 
(the to string) is to be replicated as often as necessary to make 
a string as long as the first argument* and that this replicated 
character should never appear twice in succession in the output. 

xlit also provides an escape convention for writing tabs and 
newlines so that they are visible and cause a minimum of grief for 
programs that must inspect the arguments. We use the at-sign 3 as 
an aa£i££ £&aJLa£te.£. s whatever character follows the escape 
character is in some way special. In particular* we define at to 
be a tab and 3n to be a newline* so we can write * 

St3n Sn 

to change all occurrences of M wh i tespace* (spaces* tabs and 
newlines) to just one newline and leave one word per line. 
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15.0 MISCELLANEOUS USEFUL GOODIES 



1 5,0 SIi££LU!i£m-US£BIL-£OOQI£$ 



This section covers a number of useful SES procedures that fall 
into no other category than miscellaneous* The facilities in this 
section are described briefly here* 

IAF sets up IAF terminal defaults for specific terminal types* 

OBJLIST displays CY8ER 180 object text in a readable form* 

DO a "control statement generator" that can optionally 
generate a batch job **on the fly*** 

MATH a quick and dirty desk calculator 

BELL rings the bell as an attention getter* 

BYE logs out your current interactive session* 

HEXDHP produces a hexadecimal dump of a (binary) file* 

CONCAT concatenates a list of files into a single file* with the 
resulting file "packed** into a single "logical record"* 

SCATTER performs the reverse action of COLLECT* that is it 
"scatters" a multi record file to a number of individual 
files* 
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15*1 I4£.=.S£I-U£<IliIIUL-IA£.I£E£iI!!l4L.E4SM£I£ES 

The IAF procedure defines your terminal to the NOS IAF facility* 
In addition* it will notify you of MAILBOX messages, and updates to 
SES. INFO. 

There are defaults for all the different terminal types* and 
normally* the user only specifies his/her terminal type either on 
the proc call or in his/her PROFILE. All the strange parameters* 
including the terminal type* may be set up in your profile. As an 
example* if you f re logged in to a CDC 713 terminal* you can set up 
the terminal controls by simply typing 5 

ses.iaf term»c<fc713 



The table on the next page describes the parameters for IAF* the 
defaults* and the profile variables that you can set to change the 
defaults chosen by the IAF procedure. 

Ufttfi s while the IAF procedure is running* jia Qfit hit carriage 
return CCR) to find out what*s going on* even if it does seem a 
little slow. At the time of writing* due to the way the NOS TRMDEF 
command works* hitting a carriage return interferes with the TRMDEF* 
which will issue a line of garbled data to your terminal* and the 
TRMDEF command gets ignored. In other words* the IAF procedure 
won't do anything. 
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15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



• » It 

3 * 1 * 

X Eataifiist X Ufitauli i Etafils i Eatiifitar. 
• Ma$£ * ¥aiys * tfatiatils * Usase 


1 term* t 1 No Default * term J Terminal type* For a 
! X ! J list of the terminal 

* * * 5 types currently 

* 3 * * recognized by the IAF 
X X * « procedure* see the list 

* 5 X « at the end of this 
X J XX table. 


! intchr* ic X see beiow X intchr X character to INTERRUPT a 
» * * i process. 


* termchr* tc X see below J termchr J character to TERMINATE a 
J X X X process. 


* canchr* cc X see below * canchr X character to CANCEL a 
1 ! ! * 1 ine input at the 

* 1 * * terminal. 


5 conchr* ct * see below * conchr J character to use as a 

* * * * CONTROL character when 

* * ! ! giving commands (such as 

* * X 5 Page wait on or off) to 
J J XX the TIP. 


* half/full 1 full * duplex * determines whether your 

* * * 3 terminal is to run in 
X X J J HALF or FULL duplex. 

* 5 X X These are just &SY.S. 


« ci 3 J ci X Carriage return idle 

X X J J count for IST3 or TI745. 


Jll 50 * li 5 Line feed idle count for 
X X XX IST3 or TI745. 


* hardcpy X no * hardcpy * If you use a hardcopy 
« » *' device on your IST3* the 
? * " ' defaults for ci and It 
J t 5 ! are changed to 50 each. 



The defaults given above, namely "IAF default"* are those chosen 
by IAF (part of NQS)» as opposed to IAF (the SES procedure). We 
have copped out by not stating what they are here* since they change 
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from time to time. For a fist of the defaults* consult the IAF 
reference manual* or see your local NOS wizard* 

The term Cfor terminal) profile variable is set up when you use 
8LDPR0F (BuILD PRGFile)* and the IAF procedure uses this profile 
variable* If you use the IAF procedure and no terminal type is 
specified* either via the tern parameter or the term profile 
variable* IAF prompts for the terminal type. You can edit your 
profile to insert all the other defaults if you wish* 

Terminal types that the IAF procedure knows about at present 
are s 

CDC713. CDC751. CDC752. DX132A. NCR620* TI745. TTY43* DECW3. 
TEK4014* IST3. 
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15*1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



The table below describes the control characters and other 
parameters that the IAF procedure establishes for you* Hatfi s that 
a page width of zero CO) allows the maximum page width* 



4. . 4..— „ 4._, 4. • 4. — ..4.-.-, 4— , 4. •+ 

J TERM- iCONTRQL 5 CANCEL t INTER- 5 TERM- ?PAGE I PAGE SECHO- I 

J INAL i CHAR i CHAR i RUPT t INATE .WIDTHS LENGTH SPLEX I 

S TYPE S J J CHAR S CHAR 5 J SMODE S 

t * « t a t » *• 

S CDC713 S ESCAPE S LINE J STX I ETX S S 16 S FULL ! 

S J S CLEAR 1 5 J ? ! S 

• I 4 * t (I I « 

I « 1 * 1 1 I i i 

4> , „- 4.™— . 4. , 4. .„ 4.™* 4.. -—>-» + ——-4™ + 

• i • < i «• t * 

i CDC751 J ESCAPE • GS J CTRL/P S CTRL/T 5 J 24 J FULL J 

« t « • * «t § » 

« » * t 1 » * ** 

4., » -4.™. 4. -4. — — 4.^ — 4. — . 4. 4. — . — —4. 

• • « * ■ • t 1 * 

• t * « t •* * » 

? CDC752 ! ESCAPE J CTRL/X 5 CTRL/P ! CTRL/T JO? 24 { FULL ? 

• 4 i * t at • • 
i * i t i i * i • 

4.. 4. . 4., , 4. . 4.— 4. 4--— + - * 

• t « » » » « it 

! DX132A I % J CTRL/X J CTRL/P J CTRL/T ? 132 S 30 5 FULL S 

• f • * • •* •» 

• 1 t • * « i it 

4. , 4. 4. , 4. , _ + 4. 4. 4. —-.4. 

« * • f 1 «i it 

t 1 t * t 1* *• 

J NCR260 S 5 5 S it J 

J TI745 J J J ', 5 J 5 

? TTY43 S ESCAPE ! CTRL/X 5 CTRL/P S CTRL/T S S N/A J FULL 5 

! DECW3 I J S J J I S S 

S TEK4014S 5 S 5 S S Si 

i IST3 ! i J i 5 S Si 

1 * • • * 11 i« 

1 1 « * * »i 11 



The default values can be changed by coding a parameter that 
corresponds with one of the columns marked with ** If half duplex 
is desired* simply code the half &£*• 

ttfltfi * when specifying an octal code to change a default value* 
remember that the radix* enclosed in parentheses* must follow the 
number* for example s 

conchr*33f 8) 
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15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



tlatfi ' character values can be changed by entering the desired 
character enclosed in string quotes (apostrophes)* instead of octal 
numbers. 



COMPANY PRIVATE 



15-7 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User's Handbook REV? AB 



15,0 MISCELLANEOUS USEFUL GOODIES 

15,2 OBJLIST - LIST CYBER 180 OBJECT TEXT 



15.2 aa!uai™U£i-aa£a-isa_aai£a-i£n 

OBJLIST prints out CYBER 180 object text In a readable form. 
Parameters to OBJLIST are s 

i or f i 

(optional) nape of Input £ile ahich is to have its contents 

listed out* If you don»t code the i parameter* OBJLIST 

assumes the object text is on file Igo. 



(optional) name of file to receive the Qutput from 
OBJLIST. If you don f t code the o parameter* the output 
appears on file output. 



Examples of OBJLIST Usage 



ses.objlist o»li sting 

* END OBJLIST LGO -> LISTING 



ses.objlist i*binary» o«prinfyl 

* END OBJLIST BINARY -> PRINFYL 



COMPANY PRIVATE 



15-8 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 171 User*s Handbook REV: AS 



15.0 MISCELLANEOUS USEFUL GOODIES 
15*3 DO - CONTROL STATEMENT GENERATOR 



15.3 aQ_=_£a8IEGL-Sm£a£&I-££a£SAIQE 

DO accepts a list of character strings* or a file of commands* 
and outputs them to the NOS control statment stream. The stream of 
commands so generated may be submitted to the batch system if 
desired. For example s 

ses.do ( , rewind** , > , get>myfile , » , dispose»!t»yfile = pr , f , ses.catlist») 

All sorts of NOS control statements may be given as parameter values 
to the DO procedure. Note that a perfectly valid DO parameter value 
Is a call on SES processor itself* so that if you were feeling 
sufficiently playful* you could code lines like : 

ses.do *ses.do f •ses.cat I i st ,f » 

Parameters to DO are i 



cs 



un 



(optional) list of Control Statements to be output to the 
control statement file. 



(optional) name of file containing control statments to be 
executed. If you don»t code the i parameter* DO prompts 
you to enter the statments from file input. Coding the i 
parameter causes 00 to submit a batch job containing the 
stream of commands from the file. 



(optional) name of Library in which the text record given 
by the i parameter may be found. The library mat have a 
directory. You use this feature to place canned streams of 
JCL (such as build jobs! in a LIBEDIT style library. See 
the Chapter 5 for hints on how to manage LIBEDIT 
I ibrar i es. 



(optional) User Name in whose catalog the file given by the 
i parameter* or the library given by the I parameter may be 
found* if it is not in the current user's catalog. 
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15.3 DO - CONTROL STATEMENT GENERATOR 



f or file or files s 

(optional) list of LQ&&L FILES that are to be copied onto 
the end of the job file if DO is being used to create a 
batch job (one of the batch* batchn or defer ksjts are 
coded). If you code any values for the files parameter* 
DO generates the job control to CQPYBF each of the local 
files onto the et\6 of the job file before SUBMITTING it 
and also generates the control statements in the jobfile 
itself that are necessary to COPYBF those files from INPUT 
when the job runs. If any of the filenames coded for the 
files parameter are not assigned to the job when you code 
the ses.do statement* the DO procedure aborts with an 
error message. 



batch job parameters * 

These parameters are described in section 1.7 - H SES 
PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in local mode* but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 



Example of Using DO to submit a batch job 

ses.do ( • ses.gencomp minclud** 'ses.iswl 4 * •• 
•ses. print listing** *save#lgo')> batch; bye 

10.23.56. SUBMIT COMPLETE. JOBNAME IS ABLEBOD 
* JOB DO SUBMITTED 

The four control statements (mostly consisting of SES procedures 
of course!) are built into a batch job and submitted. The bye 
procedure then logs you off. 
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15.4 HATH - INTERACTIVE KEYBOARD CALCULATOR 



15.4 &tfti_ = _IfciIE&A£mE-KEXfiQAEfl-CAL£ULAIQ& 

HATH is an SES procedure that interacts with the user to provide 
a "quick and dirty" interactive calculator. Only integer arithmetic 
of 48 bits precision is provided. 

HATH works on the concept of the c.U££fiQt ££Liabl£* When MATH is 
started* it starts with a variable called VALUE* whose value is 0. 
Every time an expression is assigned to a variable* that variable 
becomes the current variable. An assignment statement with no 
variable name on the left of the operator assigns the expression to 
the current variable. Valid entries are : 



» expression assigns the value of "expression" to the current 

var i abl e. 

♦ expression adds the value of "expression" to the current 

var i abl e. 

- expression subtracts the value of "expression" from the 

current variable. 

* expression multiplies the current variable by the value of 

"expression** and assigns the result to the 
current variable. 

/ expression divides the current variable by the value of 

"expression" and assigns the result to the 
current variable. 

// expression performs the calculation current variable MODULO 

"expression" and assigns the result to the 
current variable. 

** expression raises the current variable to the power 

"expression" and assigns the result to the 
current variable* 

name ■ expression assigns the value of "expression" to the variable 

specified by "name"* which then becomes the 
current variable. 
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15.5 BELL - ATTENTION GETTER OR MAKE UP 



15,5 a£Lk.=-AII£aiIQli-£EIIE&..aa-MAKE-UE 

BELL is a useful facility for those users mho fall asleep at the 
terminal* This BELL procedure "rings the bell** a specified number 
of tines. Parameters to BELL are s 



is the (optional) number of times to "ring the bell*** If 
you don't code the n parameter* BELL rings twice* 
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15.6 BYE - LOS OUT 



15.6 flIE_r_LQS-fl]JI 

BYE is an SES procedure that sends a special control code to the 
user*s terminal* to log it out. This provides the useful facility 
that you can set a stream of SES procedures going* with the last one 
being BYE* and you can then walk away from the terminal and let the 
system get on with the job. For example* the following is a fairly 
typical sequence s 

ses.gencomp themodi; cybii; print listing; *save*lgo*» bye 

The example shown GENerates a COMPile file for module themodi* 
compiles it with the CYBIL compiler* PRINTS the listing output of 
the compiler* saves the binary output of the compiler on file Igo* 
and finally logs the terminal off via the BYE procedure. The 
programmer is able to type that line of SES procedure calls* then go 
and have tea while it's all happening. 
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15.7 HEXDMP - GENERATE HEXADECIMAL DUMP 



15.7 tt£ittaa_ = .^M£RAIE_i!ElUfl££IflAL-nU!!£ 

HEXDMP produces a printable dump of a binary file. In the dump* 
CYBER words (addressed in octal) are shown in hexadecimal with 8/12 
ASCII interpretation. Parameters to HEXDMP are : 



i i 



o i 



name of the local file from which to produce the dump. 



name to be used for the local file containing the 
printable dump. 



p or t 2 



(optional) type of dump to produce s 
P printable - 8 words per line for line printer 
T terminal - 4 words per line for terminal output 
(default) 



a or h : 

these (optional) Isg^s determine if ASCII interpretation of 
the dump is to be included in the output. If you code the 
a &£!# ASCII is included - this is the default action. If 
you code the h {££* (Hex only) j££x» ASCII is qs£ included in 
the dump. 



Example of HEXDMP Usage 



ses.hexdmp filel tlist t 
* FILE DUMP COMPLETE 

This command creates a file 'TLIST 1 suitable for displaying on 
terminal showing the contents of file •FILEl 1 in hexadecimal. 
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CONCAT concatenates files onto a single "group" file. It is 

similar to COLLECT except that CONCAT works with files instead of 

records* and the resultant group file is PACKed upon completion of 
the process. Parameters to CONCAT are s 

I or f : 

is a list of names of files to be concatenated onto the 
group file. 



g or group * 

{optional) name of group file to receive the final 
concatenated set of files. If you don't code the group 
parameter* CONCAT uses the value of profile variable group 
f and if there's no such variable defined* uses the name 
group. 



msg or nomsg ? 

these Coptional) &e.j[S control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Examples of CONCAT Usage 



ses.concat { myf i I e#hi sf i le> anyf i I e ) 

* MYFILE -> CROUP 

* HISFILE -> GROUP 

* ANYFILE -> GROUP 

* END CONCAT MYFILE, .ANYFILE -> GROUP 



ses.concat (gr ab>hold>gr Iptclutch) g*tltefln» nomsg 
* END CONCAT GRAB. .CLUTCH -> TITEFIN 
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15.9 aC^II£a^^C4II£S.A.ailLIl-a£CQiQ-£IL£-IQ^Qia£S-EIL£S 

SCATTER copies the records of a multi record file to a number of 
other files. Parameters to SCATTER are s 

i or f i 

list of names of £iles or Berober files to which the records 
of the single file are to be copied* Names say appear in 
the list more than once* if you want to divert sundry 
records to the same file* 



g ot group : 

(optional) name of GROUP file containing the records to be 
copied* If you don't code the g parameter* SCATTER uses 
the value of profile variable group* and if there's no such 
variable defined* uses the file name group* 



if you code this (optional) k&l» SCATTER does a&£ rewind 

the group file before starting the copy sequence* If you 

don't code the nr issi* SCATTER rewinds the group file 
before doing any copying* 



Examples of SCATTER Usage 

ses.catalog newprox 

GETPXDB..TEXT TOOLDOC. .TEXT GETMAU..TEXT COMPARE. .TEXT 

GENCORS..TEXT GENREVB. .TEXT CP AS180..TEXT 

* END CATALOG NEWPROX 

s es. scatter leer bic»varnel*tav lot •cerbic>varnel*cerbic»footle)»*.** 

* •? g*newprox 

* END SCATTER CERBIC. FOOTLE <- NEWPROX 
ses.catalog cerbic 

GETPXDB..TEXT COMPARE. .TEXT GENREVB.. TEXT 

* END CATALOG CERBIC 
ses.catalog varnel 
T00LD0C..TEXT GENCORS. .TEXT 

* END CATALOG VARNEL 
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The example shows how SCATTER is used to separate the records 

from the file newprox onto the different files given In the list on 

the SCATTER call* The CATALOG procedures are used here to show the 
"before and after" effect of SCATTER* 
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i6,o HAtiaLiiifi-U£aAi£.e&afiRAtt-LiftaARi£s 



For those who use UPDATE as the source text maintenance regime 
for software devel opment* the set of SES procedures described below 
supply a fairly easy to use interface to UPDATE* A short summary of 
these SES procedures appears first* with the more detailed 
descriptions following. The SES procedures to drive UPDATE are as 

follOWS 2 

GENUPCF £E.tierate JJEdate Compile £ile. Generates a compile file 
for specified decks with modsets optionally applied. 
Either a Quick mode or Full mode UPDATE can be 
performed. 

GENUPSF S£^erate Update Source £ile. A source file may be 
generated for specific decks or common decks* with 
modsets optionally applied. 

GETDECK ££I fi£C&<s) for editing. This is intended as a 
preliminary to a GENMOD(S) procedure usage in order to 
generate modsets. 

GENMODCS) SEfcJerate flQQi f i cati on Sets for decks on a PL. GENMODS 
uses the SCOOP utility to compare two files and generate 
UPDATE modification directives. 

UPDATE applies a list of modsets to an old program library and 
creates'a new program library. 
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£SQ£IL£-Ma£ia&i£-£a£.UEaAI£-Ea£mU£S 

The update procedure interfaces use only three profile variables* 
but these are of great utility when you»re working on the same PL 
for long intervals* The profile variables are s 

oldpl name of the program library to be used when generating 
compile files* edit files and so on. It is the default for 
the pi or oldpl parameter on the procedures. 

newpl name of a new program library when running the UPDATE 
procedure. It is the default for 
the npl or newpl parameter on the UPDATE procedure* 

plowner £L Q£HE£ ^s the user name of the catalog in which the 
program library resides* It is the default for 
the un parameter on all the procedures* 

updtmcc UEQale faster Control Character* If you're working with 
such things as 'slash PL's** this profile variable is 
useful for overriding the standard master control character 
which is the asterisk (*) character. 
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In order to get the best use out of the UPDATE interface 
facilities* it is anticipated that users Hi II follow the set of 
working procedures outlined below. 

o Most of the procedures work on the concept of applying modsets 
to an existing program library* and only making a new program 
library at fairly infrequent intervals* say once every two 
weeks or so. This allows many people to be working on 
unconnected decks at a time* with one person controlling the 
building of new program libraries. 

o To make modifications to a deck* use GETDECK to generate an 
EDIT FILE (Plus a COMPILE FILE); edit the edit file* then use 
GENMODCS) to generate modsets which can then be used in 
subsequent GENUPCF runs. 

o To make major changes to decks* use GENUPSF to get the source 
of the deck out* and edit that. 

The working scheme suggested here has been in use* successfully* 
for some time. It is far easier to comprehend and handle than it is 
to be 'manually* creating correction sets. Pictorially* the scheme 
looks something like this s 
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in practice* on the next page tbere*s an 

session of work involving the three widely 

GENMQDCS) and GENUPCF* We want to generate 

««.,« ^„,.„i, ««ksw User typing is 

assumed that 



To show how this goes 
example of a complete 
used procedures GETDECK* 

modsets for decks "delta*** and M mu w through "phi". 
In lower case* and NQS messages in UPPER CASE* It is 



the program library - PROSLIB - is specified In your profile* 
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ses.getdeck d* ( de I t a>mu. »ph H 

* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EDTFILE 

* END GETDECK EDTFILEt COMPILE <- PRQGLIB 

edlt.edtf lie 
• • • 

editing 
session 

EDIT, EDTFILE 

ses.geniods anymods jan0879 cd*( del ta> rau. . ph i ) 

* END GENMQD COMPILE* EDTFILE -> ANYMODS 

ses.genupcf anymods 

* GENERATING COMPILE FILE COMPILE 

* END GENUPCF COMPILE <- PROGLIB 

As you can see from the example* the amount of typing you do is 
small, there are In fact only four commands (excluding the actual 
edit session commands) # the system does the rest* 
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1 6, 1 a£iy£C£-r-S£M£EAI£«UEaAI£-.Ca£l£IL£-£IL£ 

GENUPCF generates a compile file for any specified decks on an 
UPDATE program library* Modsets can be applied also. Parameters to 
GENUPCF are : 

m or mods * 

is an (optional) list of names of files containing modsets 
to be applied against the PL when generating the compile 
file. One or both of the nods parameter and the d 
parameter must be specified. 

d or ail : 

is an (optional) list of deck names to be placed on the 
compile file. If the alt &£¥ Is coded* this implies a full 
update in which case aa de.c.& aaafiS Stiauld £>£ &£££i£i£,d« 
One or both of the mods and the d parameter must be 
speci f I ed. 



cf s 

(optional) name of the file to receive the Compile £iie. 
If you don't code this parameter* the compile file appears 
on a file called compile. 

pl or oldpl : 

(optional) name of the UPDATE program library from which to 
generate the compile file. If you don't code the pl 
parameter* GENUPCF uses the value of profile variable oldpl 
as the name of the program library* and if there's no such 
profile variable defined* uses the name oldpl. 



un 



(optional) name of user in whose catalog the program 
library resides. If you don't code the un parameter* 
GENUPCF uses the value of profile variable plowner (PL 
OWNER) as you name* and if there's no such profile variable 
defined* GENUPCF uses the name of the current user. 



status or sts : 

Is the (optional) name of a job control register to receive 
the status of the process. This parameter is of use when 
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GENUPCF is being used as a building block of a larger 
procedure* Status must be one of Rl» R2» R3 or EF. The 
specified register is set to zero CO) in the event of a 
successful completion* and to non zero if the UPDATE 
process bombs for any reason* 



msg or nomsg s 

these loptional) Isfi^S control the generation of 
informative messages by this procedure and are fully 
described In section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES*. 



nodr op 



mc 



coding this (optional) &£¥ specifies that UPDATE errors do 
not abort the procedure. nodrop is useful where GENUPCF is 
used as a building block of larger procedures or jobs. 



(optional) faster Character to be used instead of the 
standard master character (*). If you don't code the mc 
parameter* GENUPCF uses the value of profile variable 
updtmcc* and If there*s no such profile variable* uses the 
default master character asterisk (*). 



Examples of GENUPCF Usage 



ses.genupcf modfile 

* GENERATING COMPILE FILE COMPILE 

* END GENUPCF COMPILE <- MOLDPL 



ses.genupcf m* (modsl»mods2 ) • d»( al I di g»*#hi lestdef inesl • 

* GENERATING COMPILE FILE XPANDED 

* END GENUPCF XPANDED <• ANYPL 



pl»anypl 



The first example shows the simplest usage of GENUPCF to generate 
the default compile file compile from a source program library 
called moldpl (faster QLQBL) whose name is presumably defined in the 
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user's profile* The compile file is generated by applying the 
ffliodsets in the file modflle. 

The second example shows a slightly more complicated situation 
where you is applying a list of modsets and specifying a list of 
decks to be placed on a compile file called xpanded. The compile 
file is to come from a source program library called anypl. 
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16,2 GEIQECK_ = _fi£I_QECmi-EG&-£flIIIllS 

GETDECK Is used to produce two files from an UPDATE program 
library J a compile fife with sequence numbers and an edit file 
without sequence numbers. The edit file is altered using an editor 
or suchlike* The two files can then be used as inputs to GENMOD(S) 
to produce UPDATE correction sets* Parameters to GETDECK are s 



in or mods s 

is an (optional) list of names of files containing modsets 
to be applied against the PL when generating the compile 
and edit files* One or both of the mods parameter and the 
d parameter lust be specified* 

d or decks or c or corns or all s 

is an (optional) list of deck or common deck names to be 
placed on the compile and edit files. If the all &£* is 
coded* this implies a full update in which case Q£ dfififc 
Qaifii SfcauJU lis S.a££lfi£d* One or both of the mods and the 
d parameter and the nods parameter lust be specified* 



ef J 



(optional) name of the file to receive the Edit Eile* If 
you don*t code this parameter* the edit file appears on a 
f i le cal led edtfi ie* 



pl or oldpl s 

(optional) name of the UPDATE program library from which to 
generate the compile file* If you don't code the pl 
parameter* GETDECK uses the value of profile variable oldpl 
as the name of the program library* and if there's no such 
profile variable defined* uses the name oldpl* 



un 



cf J 



(optional) name of user in whose catalog the program 
library resides* If you don't code the un parameter* 
GETDECK uses the value of profile variable plowner (PL 
OWNER) as you name* and if there's no such profile variable 
defined* GETDECK uses the name of the current user* 



(optional) name of the file to receive the compile file* 
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If you don«t code this parameter* the compile file appears 
on a file called compile. 

status or sts * 

is the (optional) name of a job control register to receive 
the status of the process* This parameter is of use when 
GETDECK is being used as a building block of a larger 
procedure. Status must be one of Rl* R2* R3 or EF. The 
specified register is set to zero (0) in the event of a 
successful completion* and to non zero if the UPDATE 
process bombs for any reason. 



msg or nomsg : 

these (optional) &.£¥.£ control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



nodrop s 

coding this (optional) &£* specifies that UPDATE errors do 
not abort the procedure, nodrop is useful where GENUPSF is 
used as a building block of larger procedures or jobs* 



mc 



(optional) faster Character to be used instead of the 
standard master character (*). If you don f t code the mc 
parameter* GENUPSF uses the value of profile variable 
updtmcc* and if there's no such profile variable* uses the 
default master character asterisk (*)♦ 



Example of GETDECK Usage 



ses. get deck ( t I s t* of * to days* modsets* to* appl y* against* the* pi ) 

* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EDTFILE 

* END GETDECK EDTFILE* COMPILE <- SOLDPL 



This example shows a whole raft of modsets applied to a program 
library whose name you defined as SOLDPL (Super QLQEL) in the 
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profile. The compile file and edit file names take their defaults 
of compile and edtfHe. The edit file edtfite may now be edited to 
provide a basis for a GENHOD(S) run to generate some more roodsets. 
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16.3 fi£!ittQaiSl-=-fi£HE&AIE-SQaSEn-EQg-il£fiAI£ 

GENMQD(S) uses the SCOOP utility to compare two files - a new 
file and an old compile file with sequence numbers - and produce an 
UPDATE correction set which can subsequently be used by the other 
UPDATE interface procedures* Parameters to GENMQD(S) are s 



m or mods : 

(optional! name of file to receive the generated modsets. 
If you don't code the m parameter* GENMOD(S) places the 
generated modsets on a file called modsets. 



I or id or ident ? 

(optional) name of the IDENT to appear as the first line of 
the generated modsets. If you don't code the ident 
parameter* the ident name defaults to that of the file 
specified by the m parameter. 

c or cd s 

(optional) Compile directives are the name(s) of deck(s) to 
be compiled when the modsets are eventually applied in a 
compile file generation. Ranges of decks may be 
spec i f I ed. 



n or new s 

(optional) name of the NEW file (the edited file without 
sequence idents). If you don't code the new parameter* 
GENMOD(S) uses edtfile* which is the default edit file name 
generated by GETDECK. 



o or old i 

(optional) name of the OLD file (compile file with sequence 
idents). If you don't code the old parameter* GENMOD(S) 
uses compile* which is the default compile file name 
generated by GETDECK. 



mc 



(optional) faster Character to be used instead of the 
standard master character (*). If you don f t code the mc 
parameter* GENMGD(S) uses the value of profile variable 
updtmcc* and if there's no such profile variable* uses the 
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default master character asterisk (*)» 



Examples of GENMQDCSJ Usage 



ses.gennods m«today id*jan08 cd* ( decka* dek I as t) 
* END GENM8DS COMPIL£:EDTFUE -> TODAY 



ses, genmods tuesday jan09 new*good old*broken 
* END GENMODS BROKENJGOOD -> TUESDAY 
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16.4 £E!iUEiE-=-S£iiE&AIE-U£aAIE.MU&CE-EILE 

GENUPSF generates a source file for any specified decks on an 
UPDATE program library* Hodsets can be applied also* Parameters to 
GENUPSF are : 



n or nods : 

is an (optional) list of names of files containing modsets 
to be applied against the PL when generating the source 
file. One or both of the mods parameter and the d 
parameter fysi be specified* 



d or decks or 

c or cons or 

alt deck or allcom : 

is an (optional) list of the things to be placed on the 
source file, d or decks is a list of £E£&S. to be placed on 
the source file, c or cons is a list of CQa&Qti &EC&S to be 
placed on the source file* Coding the alldeck or the 
all com &£*£ indicates that a full mode update If to be 
performed* in which case no. dscfc QifflfiS StiauLd k& iafifiififiJl 
• One or both of the nods and the decks parameter jsMSt he 
speci f i ed. 



sf 



(optional) name of the file to receive the Source £ile. If 
you don't code this parameter* the source file appears on a 
file cal led source. 



pl or oldpl s 

(optional) name of the UPDATE program library from which to 
generate the source file. If you don't code the pl 
parameter* GENUPSF uses the value of profile variable oldpl 
as the name of the program library* and if there's no such 
profile variable defined* uses the name oldpl. 



un 



(optional) name of user in whose catalog the program 
library resides. If you don't code the un parameter* 
GENUPSF uses the value of profile variable plowner (PL 
OWNER) as you name* and if there's no such profile variable 
defined* GENUPSF uses the name of the current user. 
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status or sts • 

is the (optional) name of a Job control register to receive 
the status of the process* This parameter is of use when 
GENUPSF is being used as a building block of a larger 
procedure* Status must be one of Rl* R2* R3 or EF* The 
specified register is set to zero (0) in the event of a 
successful completion* and to non zero if the UPDATE 
process bombs for any reason* 



msg or nomsg s 

these (optional) lifixs control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 



nodrop 



mc 



coding this (optional) fcfiv. specifies that UPDATE errors do 
not abort the procedure* nodrop is useful where GETDECK(S) 
is used as a building block of larger procedures or jobs* 



(optional) faster Character to be used instead of the 
standard master character (*)* If you don*t code the me 
parameter* GETDECK(S) uses the value of profile variable 
updtmccf and if there f s no such profile variable* uses the 
default master character asterisk (*)« 



Examples of GENUPSF Usage 



ses*genupsf c* 9 git$ncs , # pl^mcspl* un«jej0102 

* GENERATING SOURCE FILE SOURCE 

* END GENUPSF SOURCE <- MCSPL 



ses.genupsf ( modsone*modstwo) • d*deckone. • decktwo* s«newfile 

♦ GENERATING SOURCE FILE NEWFILE 

* END GENUPSF NEWFILE <- QLDPL 



The first example shows GENUPSF used to place a common deck onto 
the source file (which defaults to source since it wasn*t 
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specified)* Note the use of string delimiters {») because the 

common deck name gitSmcs has a $ sign in it* Also in this 

example both the program library name and you name where It is to be 
found are specified* 

The second example shows a pair of isodsets being applied to the 
program library called oidpf in order to generate a source file for 
a range of decks deckone thru decktwo* with the source file 
appearing on a file called newfile* 
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UPDATE applies a list of modsets against an old program library 
to produce a new program library in UPDATE format* The old and new 
program library names can be the saie# in which case the old program 
library is rewritten, fclatfi J that program library creation is the 
9l£Lx function performed by this UPDATE procedure - simultaneous 
compile file generation is aat done. Parameters to UPDATE are s 

mods or m s 

list of one or more file(s) containing the HODification 
Set(s) to be applied against the program library specified 
by the pi parameter. 

pl or oldpl : 

(optional) name of OLD Program Library to be updated from 
the correction set file. If you don't code the pi 
parameter* UPDATE uses the value of profile variable oldpl 
as the name of the program library* and if there's no such 
variable defined* UPDATE uses the default name oldpl, 

npl or newpl s 

(optional) name of New Program Library to be created when 
the update has been completed. If you don't code the npl 
parameter* UPDATE uses the value of profile variable newpl 
as the name of the new program library* and if there's no 
such variable defined* UPDATE writes the new program 
library over the old program library specified by the pl 
parameter. 



un 



(optional) User Name in whose catalog the program library 
specified by pl/npl is to be found* if pl/npl is not in the 

catalog of the current user. If you don't code the un 

parameter* UPDATE uses the value of profile variable 

ptowner as the user name from whose catalog the program 

library is to be obtained* and if there's no such variable 
defined* UPDATE uses the current user's catalog. 



lock or nolock s 

these (optional) parameters determine whether the program 
library update process is interlocked against simultaneous 
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16.5 UPDATE - UPDATE PROGRAM LIBRARY WITH CORRECTION S£T(S) 



updates; coding a filename for the lock parameter 
determines the name of the interlock file. Interlocking is 
the ififaylt action when the program library being updated 
is in another user's catalog. If you don't code either of 
the lock or nolock &£*£> interlocking is controlled by the 
lokmode profile variable* Refer to the introductory 
sections of this chapter for information on the 
interactions of the lokmode profile variable and the lock 
and nolock parameters. If you don't code a filename for 
the lock parameter* the contents of profile variable 
intrlok is used as the interlock filename; if there's no 
such profile variable* the name intrlok is used as the lock 
filename. The interlock file iysi be in the same catalog 
as the program library being updated. If the interlock 
file cannot be found* the procedure aborts. 



status or sts : 

is the (optional) name of a job control register to receive 
the status of the process. This parameter is of use when 
UPDATE is being used as a building block of a larger 
procedure. Status must be one of Rl# R2* R3 or EF. The 
specified register is set to zero (0) in the event of a 
successful completion* and to non zero if the UPDATE 
process bombs for any reason. 



msg or nomsg : 

these (optional! isfiis. control the generation of informative 
messages by this procedure and are fully described in 
section 1.8 - "INFORMATIVE MESSAGES FROM SES PROCEDURES". 



mc 



(optional) faster Character to be used instead of the 
standard master character (*). If you don't code the mc 
parameter* UPDATE uses the value of profile variable 
vpdtmcc* and if there's no such profile variable* uses the 
default master character asterisk (*). 
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Example of UPDATE Usage 

ses. update (monday* tues day* f r i day ) • pt«cobolpl 

* APPLYING MONDAY. •FRIDAY TO COBOLPL 

* NEW LIBRARY ON SESTNPL 

* NEW LIBRARY NOW ON COBOLPL 

* SESTNPL PURGED 

* END UPDATE COBOLPL 

This example shows a list of modifications in files nonday* 
thursday and friday applied against the cobolpl program library* 
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17.0 mU£Iii&£IL.£RQi:E£a-IQOLS 



CADS-=_MttMIE&-AIfi£Q-a£SISH-QE-SQEIMARE 

The structured process tools are a set of Data Dictionary 
utilities and a Computer Graphics Design tool* They support the 
Structured Analysis/Structured Design (SASD) methodology used for 
development of software* 

CADSG creates or updates DFD» SCT and DSD diagrams used in the 
SASD methodology* 

CADSGUT lists or edits diagram title blocks* 

DDCREAT creates a data dictionary* 

DDOIS displays the contents of a data dictionary* 

DDMERGE merges the contents of two data dictionaries into a single 
data dictionary* 

DDXREF prepares a cross reference listing of a data dictionary* 

DDXCHK checks a data dictionary for consistency. 
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The Computer Graphics Diagram tool supports the Data Flow Diagram 
CDFD)> Structure Charts (SCT) and Data Structure Diagram (DSD). 
These diagrams can be created* printed* saved* recalled and updated 
using a TEKTRONIX 4014 or IST-III Graphics Terminal. Other 
terminals will be supported in later versions. See the "Applicable 
Documents'* section of this document for the manual that supports the 
CADS Graphics. 

The Data Dictionary Utilities provide a set of creation* 
updating* checking and printing functions. Version 1.2 consists of 
CREATE* DISPLAY* MERGE* XCHECK and XREF functions. Later versions 
will also contain an EDIT function* See the "Applicable Documents" 
section of this document for the manual that supports the Data 
Dicti onary. 
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17.1 £AQS£-=:-CB£AI£_QB-U£aAI£-SASa-QIAfi&AaS 

The CADS Graphics tool* CADSG* supports the creation and 
maintenance of Data Flow Diagrams (DFD)* Data Structure Diagrams 
(DSD) and Structure Charts (SCT). These diagrams are the primary 
diagrams used in the SASD technique. See the SASD GRAPHICS USER'S 
HANDBOOK* ARH3981# for details of this tool. Parameters to CADSG 
are : 



ntbk s 

(optional) name of the file to be used as the current 

notebook. If you don't code this parameter* CADSG uses the 

value of the profile variable ntbk* and If there's no such 

variable defined in your profile* then CADSG uses the 
f i lename NOTEBK. 

newntbk : 

(optional) name of the file to be used as the new 
notebook. If you don't code this parameter* CADSG writes 
the notebook back to the current notebook file (see ntbk 
parameter) • 



term 



baud 



(optional) name of your terminal type* TEK4014 or IST3. If 
you don't code this parameter* CADSG uses the value of the 
profile variable term* and if there's no such variable 
defined in your profile* then CADSG will ask you which 
terminal type you have. 



(optional) baud rate you are running with your terminal. 
If you don't code this parameter* CADSG uses the profile 
variable baud* and if there's no such variable defined in 
your profile* then CADSG will ask you for your baud rate* 



hardcpy : 

(optional) do you have a hardcopy device attached to your 
terminal? YES* NO* Y or N. If you don't code this 
parameter* CADSG uses the profile variable hardcpy* and if 
there's no such variable defined in your profile* then 
CADSG will ask you if you have a hardcopy device. 
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eg*} 



(TEK4014 only* optional) do you have the Extended Graphics 
Module* EGM* on your TEKTRONIX 4014 terminal? YES* NO* Y 
or N. If you don't code this parameter for the TEK4G14* 
CADSG uses the profile variable egm* and if there's no such 
variable defined in your profile* the CADSG will ask you if 
you have £GM» 



sync ? 



(TEK4014 only* optional) are you running synchronous or " 

asynchronous? A or S« If you don't code this parameter * 

for the TEK4014* CADSG uses the profile variable sync* and * 

if there's no such variable defined in your profile* then J 

CADSG will ask you which you are running. 1 

If the file name does not exist or is empty* a new notebook is 
created. Use the NEW command within CADSG (see SASD GRAPHICS 
USER'S HAND800K ARH3981). 

Examples of CADSG Usage 

SES«CAD$G*NTBK*MYBQOK* NEWNTBK-MYNEWBK 

* BEGINNING CADSG ON MYBQOK 

( Interactive session with CADSG ) 

* END CADSG NOTEBOOK MYBOOK — > NYNEWBK 
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The CADSGUT SES procedure for Rl*2 provides a utility for 
complete or partial listing of the notebook file diagram title 
blocks and/or replacement of fields within these titles* 

The call format is* 

SES* CADSGUT* nt bk*pf nl*newntbk*pf n2* LIST 



ntbk 



(optional) name of the file containing the diagram 
records. If this value is not specified* the procedures 
will use the value of profile variable ntbk as the input 
file name* If no variable is defined* CADSGUT uses the 
name NOTEBK as the name of the input diagram file* 



newntbk s 



K 3 

(optional) name of the file to which the edited and/or 
converted diagram records are written* If this variable is 
not specified* CAOSGUT uses the default name NEWNT8K as the 
name of the output file* 

list : 

If list (optional) is specified* CADSGUT performs an 
SES*PRINT of the complete diagram title information from 
all diagram records contained on the Input file* 
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17.3 aaaaE4i.=-CE£Ai£-A-a4U.aiaiQ!i4&i 

The DDCREAT function takes a user text Input file and creates a 
Data Dictionary (DD) file. Parameters to DDCREAT are s 



(optional) name of the file containing the source data for 
creating the DD. If you don't code the i parameter* then 
DDCREAT uses the value of the profile variable ddi* and if 
there's no such variable defined in your profile* then 
DDCREAT uses the filename DDTEXT. The I file is not 
rewound. 



nett 



(optional) name of the file onto which the new DD is to be 
written. If you don't code the new parameter* then DDCREAT 
uses the value of the profile variable ddnew> and if 
there's no such variable defined In your profile* then 
DDCREAT uses the file name NEWDD. 



Example of DDCREAT Usage 

SES.OOCREAT I*MYTEXT* NEW*HYNE«DD 

* BEGINNING DD CREATE 

( Additional informative messages from DDCREAT I 

* END DD DDCREAT HYTEXT -> HYNEWDD 



This example shows DDCREAT used to create a new data dictionary* 
HYNEWDD* from the text in the source file HYTEXT. 
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The DDDIS function extracts entries from a data dictionary and 
writes the?n to an output text file* Extraction criteria are 
specified by directives on a directives file or by specifying a type 
key* (See Data Dictionary User's Handbook ARH3980*) Parameters to 
DDDIS are t 



old 



type 



(optional) name of an old data dictionary file from which 
to display a text file* If you don't code this parameter* 
then DDDIS uses the value of the profile variable ddotdt 
and if there's no such variable defined in your profile* 
then DDDIS uses the filename OLDDD. 



(optional) name of the file to receive the output from 
DDDIS in a form suitable for inclusion as 'asis* text in a 
FORMATted document* If you don't code this parameter* then 
DDDIS uses the value of the profile variable ddo» and if 
there's no such variable defined in your profile* then 
DDDIS uses the filename DDTEXT. 



(optional) name of the file containing directives* in NOS 
ASCII tine-image format* to the DDDIS processor* If you 
don't code this parameter* DDDIS uses the value of the 
profile variable ddd* If there's no such profile variable 
defined in your profile and a type key is not specified* 
then DDDIS accepts directives from your terminal or* in the 
case of a batch job* from the filename input* The d file 
Is not rewound* If you code the d parameter* don't code a 
type key* 



(optional) Issy. specifies a DDDIS directive keyword* 
Acceptable values for type are: all* allh* data* file* 
flow* compone* element? process* proch* module* action* 
actlonh* dfd* dfdh* set* notype* and undef; don't include a 
backslash* Coding the type parameter is equivalent to 
specifying the directives w \keyword \end w on a d 
(directives) file* If you code the type parameter* don't 
code the d parameter* 
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print s ? 

(optional) parameter to control the PRINTing of the output* » 

o file* When the job runs in batch mode and there is no o * 

file* one copy is printed automatically. If you run the * 

procedure in local mode* no copies are printed unless you I 

specifically code some print parameter. For example* you * 

code print*c*3 to obtain three copies of the parameter o * 

file* The format of the print parameter is that of the I 

parameters for the PRINT procedure* J 

Example of DDDIS Usage 

SES. DDDIS. OLD-HYGLDDD. 0*LISTIT. D*DQWHAT 

* BEGINNING DO DISPLAY 

* DD DISPLAY ACCEPTING DIRECTIVES 

( Additional DD / User Interaction ) 

* END DD DDDIS NYOLDDD > LISTIT 

This example shows DDDIS used to display selected entries from the 
data dictionary* NYOLDDD* The directives for selecting entries were 
read from the file DOWHAT* If this parameter had been omitted* 
directives would have been read from the file INPUT. The listing of 
formatted data dictionary entries was written to the file LISTIT in 
the order selected by the directives read from the file DOWHAT. 
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17.5 ttQl£&SE. = _tt£ME_I]iQ_a AIA-ttlCIIQ&A&iES 

The DDMERGE function combines two data dictionaries to produce a 
new one* Parameters to DDMERGE are s 



old i 



new : 



(optional) name of the old data dictionary file with which 
you wish to merge another data dictionary* If you don f t 
code the old parameter* then DDMERGE uses the value of the 
profile variable ddoid* and if there*s no such variable 
defined in your profile* then DDNERGE uses the filename 
QLDDD* 



(optional) name of the data dictionary file you wish to 
merge with the old data dictionary* If you don't code the 
m parameter* DDMERGE uses the value of the profile variable 
ddm* and if there 1 * no such variable defined in your 
profile* then DDMERGE uses the filename merdd. 



(optional) name of the file onto which the new DD is to be 
written* If you don*t code the new parameter* then DDMERGE 
uses the value of the profile variable ddnew* and If 
there*s no such variable defined in your profile* then 
DDMERGE uses the file name NEWDD. 



replace : 

(optional) &££ causes entries contained in the old data 
dictionary whose names are duplicated by entries contained 
in the m data dictionary to be REPLACED by the m data 
dictionary* The filename DDLOG will contain a list of 
duplicate entries and the action taken in each case* 

Example of DDMERGE Usage 

SES«DDMERGE» 0LD«NY0LDDD- M-MERGEDD* NEH*NYNEWDD» REPLACE 

* BEGINNING DD MERGE 

* END DD DDMERGE NYOLDD ♦ MERGEDD > MYNEWDD 

This example shows the use of DDNERGE to combine entries from the 
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data dictionaries HYOLDDD and HERGEDD to form a new data dictionary 
HYNEWDD. If an entry name is defined in both HYOLDDD and HERGEDD 
then the definition used in creating HYNEWDD is taken from HERGEDD* 
If the REPLACE parameter had been emitted* the definition from 
HYOLDDD would have been used* In either case an explanatory record 
is written to filename DDLQG. 
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The DDXREF function produces a formatted cross reference listing 
of part or all of the old data dictionary file* Parameters to 
DDXREF are : 



old : 



type 



print 



(optional) name of the old data dictionary file from which 
you want a cross reference listing* If yau don't code the 
old parameter* then DDXREF uses the value of the profile 
variable ddold* and if there's no such variable defined in 
your profile* then DDXREF uses the filename OLDDD* 



(optional) name of the file to receive the output of DDXREF 
in a form suitable for printing on the ASCII printer* If 
you don't code the I parameter* then DDXREF uses the value 
of the profile variable ddllst. If there's no such 
variable defined in your profile* and you're running DDXREF 
LOCAL at your terminal* the output appears on a file called 
LISTING* The I file is not rewound* 



(optional) fce.y. selects the type of entries you want to be 
included in the cross reference listing* Acceptable values 
for type are: flow* compone* element* file* data* process* 
module* dfd* set* notype* action* undef* and all* 



(optional) parameter to control the PRINTing of the output* 
I file* When the job runs in batch mode and there is no I 
file* one copy is printed automatically* If you run the 
procedure in local mode* no copies are printed unless you 
specifically code some print parameter* For example* you 
code print*c«3 to obtain three copies of the parameter I 
file. The format of the print parameter Is that of the 
parameters for the PRINT procedure* 



Example of DDXREF Usage 

SES..DDXREF* I-NYOLDDD* L«LISTIT* ALL 
* BEGINNING DD XREF 
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17.6 OOXREF - CROSS REFERENCE A DATA DICTIONARY 



(Additional Informative messages from DDXREFJ 
* END Of) DOXREF MYGLDDD > LISTIT 



This example shows the use of DDXREF to obtain a cross reference 
listing of all sections of the data dictionary MYOLDDD. The cross 
reference listing will be on the local file LISTIT* Printed copies 
could have been obtained by adding the PRINT parameter* 
PRINTMC*3.H**XLIST f I* This will print 3 copies with a header 
»XLIST». 
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The DDXCHK function runs a cross check against a data 
dictionary* A formatted listing is produced which contains the 
names of entries which meet criteria selected by the check 
parameter. Parameters to ODXCHK are 5 



old 



check 



pri nt 



(optional) name of the oid data dictionary fife you want 
cross checked. If you don* t code the old parameter* then 
ODXCHK uses the value of the profile variable ddold? and if 
there , s no such variable defined in your profile* then 
DDXCHK uses the filename OLDDD. 



(optional) name of the file to receive the output of DDXCHK 
in a form suitable for printing on the ASCII printer. If 
you don f t code the I parameter* then DDXCHK uses the value 
of the profile variable ddlist. If there's no such 
variable defined in your profile* and you f re running DDXCHK 
local at your terminal* the output appears on a file called 
LISTING. The I file is not rewound. 



(optional) |je.x specifies the kind of consistency check you 

want run against the old data dictionary. Acceptable 

values for check ares undef* unref* noref* recur* and 
full* 



(optional) parameter to control the PRINTing of the output* 
I file. When the job runs in batch mode and there is no I 
file* one copy is printed automatically. If you run the 
DDXCHK procedure in local mode* no copies are printed 
unless you specifically code some print parameter. For 
example* you code print»c*2 to obtain two copies of the 
parameter I file. The format of the print parameter is 
that of the parameters for the PRINT procedure. 



Example of DDXCHK Usage 
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SES. DDXCHK* I«HYOLDDD# L*LISTIT# FULL 

* BEGINNING 00 XCHECK 

( Additional informative messages from DDXCHK ) 

* END 00 XCHECK HYOLDDD > LISTIT 

This example sho*s the use of DDXCHK to perform a full cross check 

of the data dictionary HYOLDDD. The cross check listing Hill be on 

the local file LISTIT* Printed copies could have been obtained by 
adding a PRINT parameter. 
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a 1.0 esaEius 



A PROFILE is an Important* albeit optional* component of SES 
usage* Any user may choose to establish a PROFILE in their catalog 
or procedure library* PROFILE follows the same rules as any SES 
procedure* that is* the name of the file must be PROFILE* and the 
first line ot the profile must be the word PROFILE* From there on* 
the profile may contain just about any SES command. The most 
important aspect of the profile is the SEARCH directive* explained 
In the next section* 

Typically* the types of things that a user may place in the 
prof i I e woul d be s 

o a command to set a variable called PASSWOR to the user's 
password* Procedures which optionally run as batch jobs can 
then get the user's password without having to be told it on 
the SES control statement* 

o commands to establish defaults for library names <for the 
source code and library maintenance procedures)* tape numbers 
(and related information for the tape management procedure)* 
and other data for various procedures* 

o SEARCH directives to establish a search order for procedures* 

It is possible for a user to have more than one PROFILE* and 
select which one to use by coding the PN or P parameter on the SES 
control statement* For example* by coding : 

ses*pn»al ternate.prof i I e* procedur e_name I ist_of .parameters 

a user can use the file M al ternate.prof i I e w as the PROFILE for the 
duration of that procedure call* Also* a user may use someone 
else's profile by coding the PUN or PU parameter. For example* by 
coding J 

ses>pun*prof i I e_owner.procedure_name I i s t_of .par ameters 

a user can access the profile belonging to M pr of i I e. owner". Of 
course* the PN and PUN parameters may be used together* 
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A1.0*l SEARCH OIRECTIVE - ESTABLISH LIBRARY SEARCH ORDER 

Using the SEARCH directive* a user can establish* within PROFILE* 
the names of libraries to search when locating a procedure* and also 
the user names in whose catalogs those procedure libraries reside. 
The general form of SEARCH is * 

\ SEARCH search_spec* search. spec*... • •• 

where ••search^spec** is in the form s 

user. name 

or 

( I ibrary_name> I i brar y.name* • • • • » user.name) 

The first form indicates that the library name contained in the 

predefined variable SESLNAM is to be searched for in the catalog of 

the user specified by H user_name H * The second form gives a list of 

library names* with the last item in the list being the user name in 

whose catalog those libraries may be found* 



Examples of SEARCH Directives 

\ SEARCH USER. SSS* SES 

\ SEARCH CSESLNAW. CCG)* USER* SSS* SES 

The first example shows a simple SEARCH directive* The search 
order for procedures is first* the currently logged in user's 
catalog* then the SSS catalog* then the SES catalog* The second 
example searches first in the library given by SESLNAM in the CCG 
catalog* then in the currently logged in user's catalog* then in the 
SSS catalog* and finally In the SES catalog* 

lists * sail floe SEARCti dJxficiixfi is, fitacfisssd est &£& &ta££&&ji£ 
££ll* Second and subsequent SEARCH directives are iaQftLfiSt* 
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A 1.1 LQaAmt£.A-£E0££J2UEE 

The SES processor performs its search for a given procedure 
according to well defined and consistent rules* Basically SES has 
three methods of specifying how a procedure is to be located* The 
SES processor has an internal table which contains the following 
data i 

I ibr ary.name I user.nate 

§ ibr ary.name J user. name 
etc* 

etc* 

etc* 

+ + + 



Given that the table may be set up by one of three different 
methods which are explained in more detail in the sections 
following* the procedure that SES follows to locate a procedure is s 

1* If there's a local file of the "procedure. name*** whose first 
line is * , procedure.name*»# that file is used as the procedure* 

2* SES searches the catalog of the user whose user name appears 
as the first entry in the table* for a file of name 
**procedure_name*N whose first line is "procedure. name"* If 
such a file is found* it is used as the procedure* 

3* For each entry in the tablet a search is made for a library of 
name "I i br ary.name" in the catalog of the corresponding 
"user. name*** and searches that library (which lust have a 
directory) for a TEXT record of name "procedure. name 1 *. If 
such a record is found* it is used as the procedure* 

4* If the search is unsuccessful* an error message is issued 

-PROCEDURE procedure.name NOT FOUND- 



The next three sections provide a more detailed explanation of 
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the methods by which the SES processor has its search table set up* 
The methods are basically the default* the user name specified on 
the SES control statement* and the SEARCH directive* 



Al.1.1 DEFAULT ORDER OF SEARCH 



When the SES processor is called* it sets up the following data 
in its search tabie : 

+ 4. — • + 

I ESESLNAME I user. name J 

S SSESLNANS \ £S£SUNAM£ \ 

♦ 4- ■ + 



This table Is the normal default for SES* **user_name w is the 
user name of the current user* 

"SESLNAM* 1 is a predefined variable which contains the name of the 
SES Library NAMe* "SESUNAM" is a predefined variable which contains 
the SES User NAMe* 



Al.l. 2 SEARCH SPECIFIED ON CONTROL STATEMENT 



When the user types the SES control statement* he may specify via 
the UN or U parameter of the SES program* which user*s catalog to 
look in for the procedure specified by the call. For example 5 

ses*un«user_name. procedur e.name I ist_of_ parameters 

specifies that the procedure "procedure. name" is to be searched for 
aoll In the catalog of the user w user_name w (if the procedure is not 
already local)* In this case the SES processor modifies its search 
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table to contain only the following data s 

+-, -, +-, 4. 

\ £SESLNAN£ J user.name J 

+ + — . -+ 



where M SESLNAM W contains the SES Library NANe as before* and 
H user_name M is the user name specified on the SES control 
statement* It is also possible to tell the SES processor* via the 
LIBPFN or LPFN parameter* the name of the library to be searched for 
the procedure. For example ? 

ses# Ipf n»l I byname • procedures awe I is t_of_par ameters 

specifies that the procedure **procedure_name H is to be searched for 
Q.Q.L1 in the library H l i b_name°* In this case the SES processor 
modifies its search table to reflect the following data : 

+ + _ + 

* I i b_name « user. name J 

+ — , + + 



where "user.name** is the user name of the current user* and 
"lib. name" is the library name specified on the SES control 
statement* Of course* the UN and LIBPFN parameters may be used 
together* 



Al.1,3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTIVES 



The third method of specifying the order In which to look for the 

procedure is via SEARCH directives in the user's PROFILE* For 

example* supposing that the user's PROFILE contains the following 
SEARCH directive : 

\ SEARCH <H0LMLI8»JIMLIB*HG7t)# AH74* JF03* f ANDYLIB*ED73> 

in this case the SES processor would modify Its search table to look 
I ike this : 
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Al»1.3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTIVES 



+.. + 

HOLHLIB J HG7* 
* 

JIHLIB I HG74 
&SESINAM& ! AM74 
SSESLNAHS i JF03 



ANDYLIB 



4.-. 



! ED73 



tifitfi * SEARCH directives are ignored if the UN or LIBPFN 
parameters *ere specified on the SES control statement* 
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The SES processor processes procedures in one of three modes t 

RUN This is the normal mode. The procedure is processed* 
presumably generating control statements* and then these 
control - statements are executed* 

TEST In this mode the procedure is processed in the normal manner* 
but the generated control statements are not executed* 
instead they are placed on a designated file for possible 
inspection by the user. This mode is meant as an aid in 
debugging new procedures* 

HELP This mode is similar to test mode* however instead of 
generating control statements* a procedure set up for HELP 
mode produces some documentation on its purpose and usage* 

The modes are selectable by the user by means of parameters to 

the SES processor? and the procedure can determine in which of the 

modes it was called by means of predefined variables set up by the 
SES program* These variables are s 

MODE This variable may be compared with the variables RUN* 
TEST* or HELP to determine which of the modes Is in 
effect! for example s 

\ IF MODE » HELP THEN 

" code for HELP mode " 
\ ORIF MODE « TEST THEN 

n code for TEST mode " 
\ ELSE 

" code for RUN mode n 
\ IFENO 

PRIMOUT This variable contains the name of the PRIMary OUTput 
file* In RUN mode this is the new control statement file; 
in TEST mode this is the file designated by the test mode 
parameter on the SES call (default is SESTEST); and in 
HELP mode this is the file designated by the help mode 
parameter on the SES call (default is OUTPUT). PRIHOUT is 
particularly useful in HELP mode for directing the 
descriptive information about the procedure to the file 
selected by the user on the SES call* This may be 
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accomplished as follows * 

\ IF NODE » HELP THEN 
\ ROUT FA»PRIHOUT 

" descriptive information about called procedure M 
\ ROUTEND PRIIIOUT 
\ STOP 
\ IFEND 

tlatfi s in HELP mode* a PARMEND directive is interpreted as a 
STOP directive* to prevent a procedure not set up for HELP mode from 
doing strange or undesirable things* 



Bl.l ££L££Iia&J3fla£_Q£-QE£SAn08 

As stated above* the mode of operation for a procedure is 
selected by a parameter to the SES processor* 

TEST mode may be selected by one of the keywords : TEST* TM* or 
T« For example * 

sesi test.procedure.name I ist^of ^parameters 

processes procedure H procedure_name M in TEST mode* and place the 
generated control statements on file SESTEST; whereas 2 

ses»t»my_f i le.procedure_.name 1 i st.of .parameters 

processes procedure "procedure. name** in TEST mode* but places the 
generated control statements on file "my.file**. 

HELP mode may be selected by one of the keywords s HELP* HM* or 
H« For example J 

ses*hel p« procedure. name 

causes procedure "procedure. name" to be processed in HELP mode* and 
any descriptive information available is placed on file OUTPUT? 
whereas s 

ses»h»my.l nfo. procedure. name 

causes procedure M procedure.name w to be processed in HELP mode* but 
any descriptive information available is placed on file "my. info 1 ** 
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81. OPERATING MODES OF THE SES PROCESSOR 

81.1 SELECTING MODE OF OPERATION 



Mate s that when calling a procedure in HELP mode* a list of 
parameters should &a£ be given. HELP for a group of procedures may 
be obtained by one calf to SES# as follows 5 



ses» hel p.proc.l; proc_2? proc_3 
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ci.o £&&fl&_AiiajLaEa&aAmEja£SSASES 



This appendix describes the messages produced by the SES 
processor when errors are detected and under certain other 
circumstances. 



Syntax errors are detected when processing the SES cat! statement 
and directives within procedures* Before the individual messages 
are described* it should be noted that if a procedure is called from 
the terminal and a syntax error is detected on a line within the 
called procedure (or the procedure is called in TEST or HELP mode 
and a syntax error is detected on the call line) the following lines 
are written to the terminal J 

-ERROR DETECTED IN FOLLOWING LINE BY SES- 
the line which was in error 

* 

and the * indicates the point In the line at which the error was 
detected t\n general* the error actually occurred prior to where the 
* points)* These lines are followed by the error message itself* 



&QIE 

Syntax error messages that* at first glance* don*t appear to 
make much sense* may result from the omission of axalicit 
punctuation (e*g* commas* equal signs* parentheses* etc*)* If 
you get a message of this type* try re-entering the command with 
all such punctuation; either the error will disappear 
altogether* or you should then be able to figure out what*s 
wrong* 
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Cl.l SYNTAX ERRORS 



The individual syntax error lessages are described below. 



-REQUIRED PARAMETER NOT GIVEN- 

Meaning J a parameter required by the procedure or \ directive was 
not supplied on the call* 



-TOO FEW VALUES GIVEN FOR PARANETER- 

Meaning s the minimum number of values for a parameter were not 
given* 



-LINE OR STRING TOO LONG- 

Meaning : a line longer than 80 characters was read (from the 
procedure)* or substitution caused a line to exceed 80 
characters* or when concatenating C++ operator) two 
strings the resulting string would exceed 80 characters* 



-TOO MANY VARIABLES- 

Meaning : the called procedure (and the user*s profile) have tried 
to define too many variables (maximum is 200)* 



-TOO MANY PARAMETERS GIVEN- 

Meaning s a procedure or \ directive was called with more 
parameters than it knows what to do with. 



-TOO MANY VALUES GIVEN FOR PARAMETER- 

Meaning s more values were supplied for a parameter than its 
defined maximum* 
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-UNKNOWN KEYWORD- 

Meaning J a keyword for a parameter (or soie built in functions) 
was mis-spelled or otherwise incorrectly specified* 



-UNDEFINED COMMAND OR VARIABLE- 
Meaning 5 self-explanatory* 

-DOUBLY DEFINED OR INVALID PARAMETER- 
Meaning 5 self-explanatory* 

-VALUE OUT OF RANGE- 

Meanlng s the value given for a parameter (or function argument) is 
not within its allowed range* 

-VALUE RANGE NOT ALLOWED FOR PARAMETER- 

Meaning s a value for a parameter which is not allowed to have 
value ranges* i*e* values of the form x*«y» was coded in 
such a format* 

-EXPECTING NAME- 
Meaning s self-explanatory* 

-EXPECTING STRING- 
Meaning s self-explanatory* 

-EXPECTING NUMBER- 
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Meaning i self-explanatory* 

-EXPECTING OPERAND- 
Meaning i a name* string* or number was expected* 

-EXPECTING OPEN PARENTHESIS- 
Meaning s self-explanatory* 

-EXPECTING CLOSE PARENTHESIS- 
Meaning s self-explanatory. 

-EXPECTING COMHA- 
Meaning s self-explanatory* 

-EXPECTING EQUAL SIGN- 
Meaning s self-explanatory* 

-EXPECTING END OF LINE OR STRING- 
Meaning s self-explanatory* 

-INVALID NAME- 

Meaning : a name given was longer than 7 characters* did not start 
with a letter* or contained characters other than letters 
and digits* This message is also issued if the specified 
name is illegal in the context in which it was used* 
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-INVALID STRING- 

Meaning : a string constant was not properiy terminated* i*e* the 
closing single qyote was missing* 



-INVALID NUHBER- 

Heanlng s a numeric constant was not specified according to the 
syntax defined in section 01*3 or contained "digits" 
greater than or equal to its base* 



-INVALID COMMENT- 

Meaning s a comment was not properly terminated* i*e* the closing 
double quote was missing* 



-INVALID CHARACTER- 

Meaning t a character not in the character set table in section 
Dl*2 was encountered outside of a string constant or 
comment* 



C 1. 2 EL&aCEaURE-QRfiAHUAIIQIl-ERRQ&S 

These messages inform the user of problems with the "structure** 
of a procedure. The messages are generally self-explanatory* The 
symbol SEG should be read as "procedure segment** (i.e* a "thing** 
which Is INCLUDEd by a procedure)* 



-EXPECTING IFEND- 
•EXPECTING WHILEND- 
•EXPECTING END-SEG- 
-UNEXPECTED QRIF- 
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-UNEXPECTED ELSE- 

-UNEXPECTED IFEND- 

-UNEXPECTED WHILEND- 

-UNEXPECTED €ND-SEG- 

-UNEXPECTED CYCLE- 

-ILLEGAL USE OF WHILE/WHILEND OR CYCLE- 

C1.3 EIl£.USAS£-£&Efl&-ti£SSAfi£S 

The message s 

-FILE/RECORD filena* NOT FOUND- 

is issued when the INCLUDE processor cannot locate the requested 
"procedure segment**. 

The message s 

-FILE fMenaii ALREADY IN USE- 

is issued by either the INCLUDE or ROUT processor when the 
designated file is already being used by the SES processor. 

The message s 

-PROCEDURE procna* NOT FOUND- 

is issued »hen the requested procedure could not be found. 

CX. 4 IM£EMU£B£QR-!i£S$A££S 

If any of the foiling messages are ever encountered* the authors 
should be informed. 

-INSUFFICIENT FIELD LENGTH FOR SES- 

-INSUFFICIENT FIELD LENGTH TO CONTINUE- 
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-SES- INTERNAL TABLE OVERFLOW -TOKTAB- 

-TOKEN ALLOCATION ERROR- 

-TOKEN STACK OVERFLOW- 

-I/O STACK OVERFLOW- 

-CIO DIRECTIVE ERROR- 

-Pfft DIRECTIVE ERROR- 

In addition* the following message may be issued following any of 
the above error messages or syntax error messages s 



-INTERNAL ERROR IN SES- 



C 1. 5 iaEQR&AmE_fiESSASES.^&_PAQ&£IS 

When entering continuation lines for an SES procedure call from 
the terminal* the SES processor issues the following prompt* which 
should be interpreted as "ENTER CONTINUATION LINE": 

When the SES processor has completed processing a procedure in 
TEST mode* the following message is issued 5 

-TEST OF procnam ON FILE filenam- 

When the SES processor has completed processing a procedure in 
HELP mode* the following message is issued : 

-HELP FOR procnam ON FILE filenam- 

When the SES processor is searching for procedures or INCLUDing a 
procedure segment* i t may encounter errors with a file* In such a 
case* one or more of the following messages may be issued to the 
dayfile. The SES processor won't abort because of one of these 
errors since the procedure or procedure segment being searched for 
may not be in the file on which the error was detected. 
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CI. 5 INFORMATIVE MESSAGES AND PROMPTS 



-WAITING FOR PFN*fHena» UN*usernas)- 
•ERRGR WITH FILE PFN*fHenam UN*usernaa- 

-NO DIRECTORY PFN«f i I enaw UN»userna«t- 
-BAD DIRECTORY PFN«f i 1 enam UN»usernaffl- 
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D I . ifiairEflBfl AL-SIHIAS-QESC&IEIIQU 



"•..What is the use of repeating all that 
stuff"* the Mock Turtle interrupted* "if you 
don't explain it as you do on? It's by far the 
most confusing thing I ever heard!** 

Lewis Carroll 



This section gives a semi-formal description of the syntax used 
when writing procedures for and calling the SES* The description is 
not intended to be rigorous* First we introduce the **meta-l anguage** 
used to describe the syntax, second the character set used by SES is 
defined; and finally the syntax description itself is given* 



Dl*l Iti£.Ji£n..LAti£UA££ 

This section describes the symbols used in the description of the 
SES syntax* 



i*abal luistsxsiaUau 

::* This symbol should be read as "is defined to be*** 

J This symbol is used to indicate alternatives* for 
example s A I B means that either A or B is 
al lowed* 

<item> This group of symbols denotes that i tew is to be 
treated as a syntactic unit in relation to 
surrounding met a symbols* 

Citem3 This group of symbols denotes that item is optional* 
i.e. zero or one occurences of item are allowed* 

Citem} This group of symbols denotes that item may be used 
zero or more times* 

Spaces are used in the syntax description to improve its 
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readability* however they are not part of what*s being defined 
unless otherwise noted* 

There are a few instances where some of the raeta symbols 
themselves are part of the syntax definition* and when this occurs 
the meta symbol is underlined* for example 5 i means the S 
character and not the meta symbol* When an _ appears alone* it 
means itself* 
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D1.2 CHA&A&IE&-SEI 



Characters used for NAMES 

A • • Z a * • z ******»**» Letters 

* ♦ 9 *••••*••*•**••**••••* D ec I m a I Digits 



Characters used for INTEGER CONSTANTS 

•* 9 •*****•*••*»•••**•••• Decimal Digits 

A .. F a *• f *»•*•***•• Hexadecimal Digits 
( •*••••**•*•*•»••*•••*••••* Open Parenthesis 

1 •*••*•*••*•**••**•*••••••• Close Parenthesis 



Characters used for OPERATORS 



a************************* Plus Sign 
*»***•*»*•***•**»*»****•** Minus Sign 
••a*********************** Aster i s k 



Slash (Slant) 



»•*****•*****•***»******» Eoual Sign 
•••••••••••••••••••*••••• Greater Than Sign 



•••••••••••••••a********* 



Less Than Sign 



Characters used for PUNCTUATION 



* * * » • 

***** 



****** « 
••«*••• 



• **•••••••**••*•*••• •••••• Period 



• * * 

* * • 



•• Blank (Space) 

• * C omnia 

•• Open Parenthesis 

•• CLose Parenthesis 



Character used for STRING DELIMITER 

• *•••*•••*••«*•*••**••••••• Apostrophe (Single Quote) 

Character used for COMMMENT DELIMITER 

n •••*••*••«*•••••••••*••••« (Double) Quote 
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(Default) Character used for SUBSTITUTION DELIMITER 



• •••••»•**••••*•*•*••••••• A abp e r s a n d 



(Default) Character used for DIRECTIVE HEADER 

\ ••*••*•••••*••••••••*•*••• Reverse Slash (Slant) 



Mfltfi s Any ASCII character not listed In the above character set 

has no meaning to the SES processor. These characters may 

however be used In strings* comments* or as data 
characters* 
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01,3 SYNTAX 



Di.3 smuz 



01.3.1 8ASIC DEFINITIONS 



<upper case Ietter> ss* 



<lo*er case *etter> 



A 1 


' B 


4) 
* 


c 


* 


D 


4 

* 


E 


4 
4 


F 


4 
4 


G 


4 
4 


H 


I \ 


; j 


* 

* 


K 


• 


L 


4 

4 


li 


4 
4 


N 


4 
t 





4 

4 


P 


Q \ 


R 


4 

* 


S 


a 


T 


4 
4 


U 


4 

4 


V 


4 
4 


W 


4 
4 


X 


Y « 


! Z 


























a 


! b 




c 


« 

4 


d 




e 




f 




9 




h 


i \ 


1 J 




k 


* 
4 


1 




m 




n 









P 


q \ 


r 




s 


4 

4 


t 




u 




V 




w 




X 


y l 


! z 



























<letter> ::- <upper case letter> 

! <lower case letter> 

<deciinal d i g i t> ?s= 0313233343536373839 

<hexadecifna! digit> 5 1 = A 3 8 J C 3 D ! E 3 F 



<dlgit> :?* <decinial digit> 

! <hexadecinial digit> 

<base> ::* 2 3 3 3 4 3 5 3 6 3 7 3 8 3 9 3 10 
3 11 3 12 3 13 J 14 3 15 3 16 



01, 3. 2 TOKENS 



This section defines the building blocks of SES syntax* 
collectively referred to as tokens. The internal token scanner of 
the SES processor Is made availble to the procedure writer by means 
of the built-in function TOKEN. 



<token> ss* <name> 3 <number> J <string> 
J <delimlter> J <operator> 

<naie> sj» <ietter> C<letter> J <decimal digit» 
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<upper case name) 5 5* 

<upper case ietter> £<upper case letter) 1 <decimal digit)} 

All names are limited to seven characters in length* With the 
exception of <upper case name)s* any name may be specified with 
either upper or lower case letters* but before a name is used all 
letters in it are converted to upper case* For instance the names 
ABC* abc* a&c* and so on* are ail equivalent* (This includes any of 
the "special" names* such as DO* THEN* WHEN* etc* In this 
description* however* these names are always spelled out in upper 
case letters*) 

<variable name) :s= <name> 

<function name) ss« <name> 

<parameter name> s:» <name> 

<directive name> 55* <name> 

<assignee> JJ* <parameter name) * <variable name> 

<procedure name) ss* <name> 

<procedure identifier) ::= <upper case f\ame> 



<number> 5s* <decimal digit) £<digit>> U<base>)] 

<string character) ss* «» 

» Cany ASCII character except f > 

<string> 55* *C<string character)! 1 
<constant) 5 5* <string) » <number) 1 <name) 

<de«imiter> 5 :* * J t J ) J * J * J **€*> 
* <end of I i ne> 

<operator) ss* <graphic operator) J <mnemonic operator) 
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<graphic operator> * :* ** S * J / « // 5 ♦ 3 - * ♦♦ 



Kmnemonic operator > si» AND I OR J XOR J NOT 



COMPANY PRIVATE 



01-8 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES {Release 17) User's Handbook REV* AB 



01,0 SEHI-FORHAL SYNTAX DESCRIPTION 
Dl*3.3 USE OF SPACES 



01.3.3 USE OF SPACES 

Before discussing when and how spaces can be used we will first 
define the syntax of comments. 

<comment> J! a **C<any ASCII character except ">>*» 

In almost all cases a comment is treated identically to a single 
blank character* and 2 or more contiguous blank characters (or 
comments! are treated as a single blank character* Blank characters 
and comments treated in this manner are known as spaces* 

Spaces may be used between tokens to improve readability and in 
general may be used to replace commas when used as argument* value* 
or parameter separators* Spaces iusi be used to separate tokens 
when no <delimiter> or <graphic operator> can be used to separate 
them* For example the spaces between the tokens on the following 
line must be present 5 

VI AND V2 

whereas the following two expressions are equivalent 5 

VI ♦ V2 
V1+V2 

Further* the following value list contains 2 values J 

C X, -3 I 
whereas the next contains only 1 value : 

( X -3 I 

namely the value of the expression X-3* 

Spaces within character strings represent themselves* and 
lents may not be used in front of the \ which occurs at the 
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one or wore blank characters* 
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Dl.3.4 EXPRESSIONS 

<exur> ns <lterm> C<or> <lterm>> 
<or> s:« OR J XOR 

<lterm> si* <lfactor> CAND <lfactor>} 

<lfactor> ss* CN0T1 <Iprimary> 

<lprimary> ss* <sterm> C<rel op> <ster*» 
<rel op> *:» * 5 /* i £ 5 £* 5 i 8 *» 

<sterm> si* <term> £+♦ <terra>} 

<term> ss* Kterm op>3 <factor> £<term op> <factor>> 
<term op> JJ= + { - 

<factor> s:* <primary> C<f actor op> <orimary>} 
Cfactor op> ss* *!/!// 

<primary> ss- <operand> C** <operand» 

<operand> :*» <variable reference> 
<f unct i on r ef er ence> 
i <expr> I 
<constant> 
<nul l> 

<null> ss* 

<variable reference> :s* <var table name> 

<function reference> s:* <functlon name) <arguments> 

<arguments> ss* < £<arg> if <arg>>3 ) 
5 <null> 

<arg> :s« <name> ' <expr> 



<integer expr> sj* <expr> 
<string expr> ss* <expr> 
<boolean expr> JJ» <expr> 



w must resolve to an Integer ** 
" must resolve to a string w 
w must resolve to an integer *• 
If the value Is zero* It * 
is taken to be FALSE H 
if non-zero* It's taken M 
to be TRUE " 
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Dl*3*5 FOREIGN TEXT 

Foreign text is primarily used for parameter values which are to 
be in turn used as parameter lists <e*g* to secondary procedures) 
or simply to prevent the SES processor from evaluating an 
expr essi on* 

The scanning of foreign text is totally different from scanning 
"normal" text* The characteristics of this special scanning are 

parentheses are "balanced** 
single and double quotes are "matched** 
- if not contained within parentheses* single quotes* or 
double quotes* the tokens s comma* period* ellipsis 
(•*{*})* and close parenthesis terminates the scanning 
(and thus the foreign text value)* In addition* spaces 
which are used to separate names* numbers* or strings from 
names numbers or strings terminate scanning; as does an 
"unenclosed" open parenthesis which follows a string or 
number (Note* that an open parenthesis following a name 
does not terminate scanning - this is because function 
references are allowed in foreign text but the foreign 
text scanner doesn't evaluate what it scans* and thus does 
not know if the name is indeed the name of a function)* 

Foreign text may also be described as having the general format 
of an expression* but the expression is not evaluated when scanned 
as foreign text* During scanning comments and blanks not contained 
within single quotes are "thrown away" and single blank characters 
are inserted between tokens which would otherwise not be separated* 

The following example illustrates some of the idi osyncr acies of 
foreign text s 

\ vlist * Ma b c Id e) «»p q*«»»r» s ff 123C8) (x»(y+3U )« 

\ count « VCNT (vlist) " 2 " 

\ value * VALS (vlist. 3) " 3 " 

\ siist * GENLIST (vlist* index) » 4 " 

The first line defines a value list in the variable vlist* Line 
2 sets the variable count to the value 6* Line 3 sets the the 
variable value to the value : 

CIO E) 

and line 4 sets the variable slist to the value s 
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A#BfCID E)t f p <| f »r» s» > 123<8)> IX, C Y+3) ) 

The next example illustrates how a parameter list way be passed 
as a foreign text parameter J 

Plist * M i*infile "columns" cols*1..80 o*out )* 

count * VCNT Cplist) 

low * VALS Iplistt 2, LOV) 

high * VALS (plistf 2» HIV) 

stist * GENLIST Cplist* index) 

Count is set to 3$ low Is set to * 

C0LS«1 

high is set to 80; and slist is set to s 

I»INFILE,C0LS»1..80#Q»0UT 
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1,3.6 PARAMETER LISTS 

<parameter Hst> ss- E<pararoeter> CC # J <par araeter>}l 

<parameter> ?J s C<paraweter naie> C»31 <value list> 
* <parameter naiue> 
J <nuil> 

<value list> ?;* <vafue> 

5 < C<value> Ct#l <value»l ) 

<value> :?* <value side> C**C«> <value slde>] 

<value side> ss» <expr> \ <foreign text> 
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01.3,7 SES PROCESSOR CALL 



<csep> ?:* £|3 <end of line) 

J C.3 <end of line> 
i • « 

• 9 I * 

<proc call) s:» <procedure naie> £*3 <parameter list> <csep> 

<control statement> s:- <strlng> 

<control statements> JJ* <control statement> C<csep>l 

CC*3 Kcontrol statements £<csep>3> 

<cali element> 5S» <proc cail> J <control statements> 

<SES call> JJ- SES £* <parameter I ist>3 • 

<calt element> fXcall element>> 

Because of operating system restrictions* a <parameter list> 
following the SES (processor name! must have explicit punctuation. 
That is to say* commas must be used to separate parameters (and 
values) and equal signs must be used to separate parameter names 
(keywords) from their value lists* 

Also* the operating system is not well acquainted with lower case 
letters* so only upper case should be used? however* NAM/IAF (or 
TELEX) and the SES processor alleviates this problem by converting 
lower case letters to upper case on command and continuation lines. 

When <control statements> are used in a <SES call>* the SES 
processor insures that they are all "properly" terminated* i.e. 
each <control statement> string is scanned for a right parenthesis 
or period and if neither of these characters is found* a period is 
appended at the end of the string! if however* a right parenthesis 
or period is found* the string is left alone. NOTE that this is the 
only validity checking of the <control statement> done by the SES 
processor. 
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01.3.8 SUBSTITUTION 

<substitute> :?- <paranseter natae> I Variable naie> 
<default substitution character> ?*» £ 
<aitemate substitution character> ji» 

<substi tut ion char> ?:* 

<default substitution cbaracter> 
» <alternate substitution cbaracter> 

Csubsti tut ion> s: = 

<subst i tut ion char> <substitute> <substi tuti on char> 



COMPANY PRIVATE 



01-16 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User*s Handbook REV: AB 



01.0 SENI-FQRHAL SYNTAX DESCRIPTION 
01.3.9 PROCEDURES 



01.3.9 PROCEDURES 

<procedure> *s* <procedure identifier> £<procedure line>> 

<procedure !lne> s:» £<procedure line eleroent>> 

<procedure line element> 55* <substi tut i on> 

J <any ASCII character> 

The process of substitution applied to a <proeedure iine> yields 
an <ob ject 1 ine>* 

<object line) ss» <directive line> 

\ Kemp ty I I ne> 
S <dat a I i ne> 

<default directive cbaracter> :* = \ 

<alternate directive cbaracter> ::= 

» * 



S£*-3&:**i!13£U-" 



<directive header> JJ s 

<defauit directive character> 
« <alternate substitution character> 

<directive line> *J* <directive header> <directive> 

<en»pty I ine> s s « 

<data Jine> s*« <any line which is not "empty** and does 

not begin with a directive header> 

Bstfi * <e»pty llne>s may contain comments enclosed in double 
quotes. 
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01. 3,10 DIRECTIVES 

<dlrective> JJ» <assl gnaient> 

<if whtfe> <boolean expr> C<then do>l 
<exit cycle> CWHEN <boolean expr>3 
<directive name> <parameter I i st > 

<assi gftment> *s= <assignee> * <expr> 

<if whiie> 52* IF S ORIF 5 WHILE 

<then do> Js* THEN 

: do 

<exit cycfe> ??= EXIT 5 CYCLE 
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D 1 . 4 LIii£iatia.Itl£I£-CO(iIIIiUAIIQ^ 

Although the preceding syntax descriptions implied a totally free 
form of "language"* the SES processor actually deals with its input 
a line at a time* Ends of lines are terminators for all syntactic 
units (tokens! except as described below. 

It is sometimes necessary to pass wore parameters to a procedure 
(or give more parameters to a directive) than will fit on one line 
(fines are normally limited to 80 characters in length* however* 
TELEX further limits the command lines to about 70 characters — for 
reasons known only to TELEX — continuation lines entered at the 
terminal may* however* be 80 characters long). To handle this 
problem* SES processes continuation tines* 

The ftllfifitiy.fi net result of using continuation lines is to 
construct an unbroken land conceivably* very long) line* 

Continuation may only be used in conjunction with SES directives 
and when calling SES to process a procedure* Continuation is 
signalled on the line which is to be continued* not the continuation 
line itself* Note that the <cont i nuat ion signal> is not considered 
to be part of the line. The mechanism for doing this is defined as 
follows s 



<whole 1 i ne> ? i* 

<line starter> <stuf 1> C Continuation signal> 

<stuf 2) £ Continuation signal) 

<stuf n> > 1 



Continuation signal) s:» ..€*> 

<l ine starter) s:» <directive header) <name) 

• SES Cparameter list) 

<stuf I) 3S* <whatever belongs with the line starter) 
» 1 <* i <= n n 



The effect of this is as if <whole line) had been specified as * 
<iine starter) <stuf 1) C<stuf i>> 
tifitfi 2 Syntactic units (tokens) may flat cross line boundaries* 
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ei.o acaum.iiiiLiix 



ACQUIRE is a program that enables easy retrieval (acquisition) of 
permanent f i I est 

ACQUIRE combines the functions of the NQS "ATTACH" and "GET" 
control statements. For each file specified ACQUIRE determines if 
the file is already local to the job (unless suppressed by the PQ 
parameter* see below)* if so it is rewound; if not* then for each 
one of a list of user names* an ATTACH is attempted (Halting* if 
necessary* until the file is not busy)* and if that fails a GET Is 
tried* If* after all this* the file is still not local* an 
appropriate dayfile message is issued* 

Unless the A (abort) parameter is specified* ACQUIRE aborts only 
because of control statement format or argument errors* or because 
of a permanent file manager (PFM) detected error* and not because 
one (or more) of the specified files could not be found* 

The control statement format for ACQUIRE Is : 

ACQUIRE( If nl»pfnl* I f n2*pf n2*.**/opl*op2*. • . ) 

Ifni Is the (local) name of the file once it has been ACQUIREd 
(note that this is the name used in making the "is the file 
already local?" test) 

pfnl is the permanent file name for the file (if =pfni is omitted* 
pfni is assumed to be the same as Ifni) 

opi specify options used for acquiring the file(s) : 

A specifies that if a file is not found* ACQUIRE 

should abort 

NA is the opposite of A (and is the default) 

PO specifies Permanent Only* i.e. that if a file is 
already local* it Is returned and then the ATTACH 
and GET are attempted 

UN*users specifies a list of user names to be searched for 
each file (the user names are separated from each 
other by commas) 
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M*fflode specifies the access mode desired for the file 
(READ or R — the default* WRITE or W* or EXECUTE 
or E)» If the file is local* the mode will not be 
changed. To insure the mode will be changed* the 
?Q parameter should also be specified. 

PW*dw specifies the permanent file's password 

PN«pn specifies the packname for the permanent file 

When ACQUIRE is attempting an ATTACH or GET* if the file is busy 
or if a permanent file utility is active* the following message is 
issued and the request is retried 2 

- WAITING FOR PFM*per manent.f ii e.naie UN*user_name 

When ACQUIRE is attempting an ATTACH or GET* if an error is 
detected by PFM the following message is issued and ACQUIRE aborts 5 

- ERROR WITH PFN*peraanent_f i I e.name UN*user_name 

In both of the above cases* the designated message is preceded by 
a more specific message generated by PFH. 
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F 1. £ai.=-£liaM££a-^mM-Q£ JSQS-I£II-£QIIQ£ 



EOT is an enhanced version of the standard NOS text editor 
(EDIT)* EDT incorporates column searches* modified FIND and FINDS 
commands* Input and Output file and TAB specification on the EDT 
call* control over terminal interrupts* INPUT NODE options* multiple 
entries on command lines* command buffers* permanent file functions* 
and miscellaneous other additions* 

User documentation can be found on TQQLDOC ISESD009)* 



F 1 . 1 ED.I_£3iaiS01._$IAIEI3£!iI-£GEMI 

EDT*Clfnl1*Clfn21»Clfn31*Ctab3,£cmdstrl 

Ifnl - name of the file to be edited 

Ifn2 - name of the file containing the editor commands 
(default * INPUT) 
- if 0* an END command is executed after processing the 
commands in cmdstr 

if 1* commands are read from file INPUT after 
processing the commands in cmdstr 

Ifn3 - name of the output file (default * OUTPUT) 

tab - tabset to be used by EDT 

cmdstr - editor Command String to be executed if Ifn2 * or I 
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EXTRACT is a program that enables easy retrieval of records from 
permanent file (or local) libraries* 

Although EXTRACT is designed primarily for use in procedure 
files* it is also very useful on its own. 

EXTRACT is similar in function to the NOS "GTR H statement. It 
differs from M GTR W in the following ways: 

o EXTRACT insists that the library to be searched has a 
directory (a directory can be built using the NOS utility 
M LI8EDIT W ). 

o The record type parameter for EXTRACT* if given* applies to 
all records to be extracted* and if not given* only the names 
of the records are used when searching the library* 

o Each extracted record Is copied to its own local file by 
EXTRACT* rather than all to the same file. 

o EXTRACT does not insist that the library to be searched be 
local to the job when it f s called* but ACQUIRE f s the library 
from a permanent file catalog. 

The control statement format Is: 

EXTRACT( I fnl»rnl* I fn2»rn2*. ../opl*oo2>... ) 

Ifnl Is the local file name given to the record once it f s 
extracted (Ifni is REWOUND before and after the extraction 
takes place). 

rnl Is the name of the record to be extracted (if omitted* it is 
assumed to be the same as Ifnl). 

opi These parameters specify options that control the extraction 
process s 

A Specifies that If a record is not found* EXTRACT 

should abort. 
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NA Is the opposite of A (and Is the default)* 

T*rt Specifies the record type (if given* it applies 

to all records being extracted? if omitted* only 

the record names are used when searching the 
1 ibrar y)* 

LMibname Specifies the name of the library to be searched 
for the records (if omitted* "RR0CLI8" is 

assumed) • 

LFN-llblfn Specifies the local file name for the library 
(if omitted* the "libname" from the L paraeter 
is used)* Note that this is the name used to 
make the "is file local?" test when ACQUIRing 
the I i br ar y* 

UN»un Specifies the user name of the permanent file 
catalog to be searched for H libname w if it's not 
already local (if omitted* the current user is 
assumed )• 

py»pw Specifies the library's permanent file 
password* 

PN*pn Specifies the library's permanent file 
packname* 

Valid record type designators are documented under the 
description of the "CATALOG" control statement in the NOS Reference 
Manual « 

In addition to these standard types* there's one more "type" 
processed by EXTRACT* which is designated by "TXT"* This "type" is 
used to denote "TEXT" records that* when extracted* are to have 
their first line (which contains the record's name) "stripped off"* 
This is useful if* for example* one has records containing 
directives for a NQS utility* in which case the name of such a 
record Is in all likelihood an illegal directive to the utility 
program* 

EXTRACT aborts under any of the following conditions: 
o foruat or argument error(s) on the control statement 
o the specified library could not be AQUIREd 
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the library file does not have 
before end-of-inf ormat i on 



a directory as the last record 



Note* however* that EXTRACT doesn't abort if it does not find any 
of the requested records (only an informative dayfiie message is 
issued)* unless the Abort parameter is coded on the call* 

If the library file is not local to the job when EXTRACT is 

called* it is RETURNed when EXTRACT terminates normally; but» if the 

library file is local, EXTRACT REWIND'S it prior to normal 
termination* 
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H1.0 S£SMSG_UIILIIX 



SESMSG Is a program which copies the comment field of its call 
line to a fife* The control statement format is: 

SESMSG* f i I e. message 

file is the name of the file to receive the message (if 
omitted, OUTPUT Is assumed) 

message is the message to be written to the file 

The message is written to the file only If the file is a terminal 
file, or if w file w is explicitly quoted on the call line* 

SESMSG is used in procedure files to inform the user about what 

the procedure is currently doing* It is also used for creating 

files of input directives to utility programs when such directives 
are dependent on execution time considerations* 
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1 1 . «&IQ.::.EfififlUCE.L A&SE-£&LHI-&AlMi£R 



JOBID is the program used by the SES PRINTID procedure to produce 
"large print" banner pages* 

The output produced is one or more pages of 5 lines of block 
characters at 10 characters per line. All empty character positions 
and lines are blank filled* Additional pages of block lettering is 
produced if any information is specified following a fifth delimiter 
character* and so on* 

The input to JQBID is a string of characters in the following 
form s 

Iinel/iine2/l ine3/i ineWI ine5 

or 

/////+! Inel+I ine2+l i ne3+l ine4+ I i ne5 

In the first form the slant (/) character is taken to be the 
delimiter between lines (i*e* it is the default delimiter)* The 
second form must be used when you want one or more of the lines to 
contain the slant character* In the example above* the delimiter 
has been changed to a plus (♦) character* 

tifltfi ! that only characters with a 6-bit display code 
representation can be given to JOBID* To produce a colon Hi on 
output you should use a percent sign {%) on input* Unnecessary 
delimiters after the message data should be omitted* otherwise a 
trailing delimiter may be printed* 

Autai£li£_&£];s-a£4.1ii£.*iub&ti£u£ii2u 

Once JOBID has broken the message field into message lines based 
on the delimiter character* the front of each field is examined for 
the following sequences of characters : 

)DATE 
)TIME 
)ETAD 
UMPH 
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Whenever these character sequences are found* the message line on 
which they occur is replaced with the current value of the indicated 
parameter. (NOTE that the right parenthesis must be the first 
character of the message line on which it occurs). 

The above "commands** produce the following types of results : 



)0ATE 


17 SEPT 74 


ITIME 


14318:21 


)ETA0 


74/09/17 


)AMPM 


3:05 PH 



(date reversed) 



*LQ&ID.-£&£!&l£S 

GRAPL/OLDPL/TAPE »/ 7777 

TEXTJAB/COMPILE/ QF/)0ATE/ ) TIME 

/////♦CREATED ON* 17/09/74++L ATE ST RUN+)DATE 

SEND TO/MEADOWVALE/RQGM 888 

/DAYFILE/DUMP/IETAD 

The above calls produce the results shown below : 

GRAPt TEXTJA8 CREATED ON SEND TO 

OLDPL COMPILE 17/09/74 MEADGWVALE DAYFILE 
TAPE * OF ROOM 888 DUMP 

7777 17 SEPT 74 LATEST RUN 74/09/17 

13335:26 18 SEPT 74 



COMPANY PRIVATE 



Jl-1 

CDC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User f s Handbook REVS AS 



J1*0 TXTHEAO DOCUMENT (HEADINGS) POST-PROCESSOR 



J 1.0 IXIU£Aa-aQCU!i£tlI.IIi£Aail!lfiSl-EQiI=£aDCESSfl£ 



Sometimes the header material generated by TXTFQRM is not desired 
or TXTFORM is unable to produce a needed header format. The TXTHEAD 
utility processes a TXTFORM output file* which contains special 
TXTHEAD instruction pages* and removes the old header material 
and/or inserts the new heading material* Additionally* an 
incrementing page number can be produced at any position within the 
header text* or the TXTFQRM page number may be passed to TXTHEAD for 
placement into the header region* 

///HEAD New heading material follows until another /// is 

encountered in columns 2*3*4* 

///END Usually marks end of special heading material* 

///PAGEC-lnn Set page number for next page to nn. If negative* 

the page number is not printed until it increments 
to 1. 

///LINEnn Line nn of header on which to put a page number* 

///COLUMNnn Column position for units digit of page number is 

nn» for TXTHEAD generated page nos** and for 
TXTFQRM generated page numbers the column position 
specifies the location of the left hand side of the 
page number* (Count includes carriage control 
co I umn)* 

///ADDNQnn Number of header lines to be added is nr\» Default 

is add all lines given* 

///DElETEnn Number of lines to be deleted from top of each page 

is nri m 

///QLDNO Use the TXTFQRM generated page nos* 

///NEWNQ Use the sequentially generated TXTHEAD page nos. 

This is the default condition* 
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To give these commands to TXTHEAD* the following type of format 
should be used in a TXTCODE document at the place where the change 
is to occur. 

Yasis 

\marginl 
\length80 
\page 
///head 

* HEADER TEXT * 

* * Page 

///end 

///pagel 

///tine3 

///column65 
///deiete3 

XmarglnlO 
\length62 
Nblock 
Vpage 

Header information as well as any specifiable information may be 
defined or redefined anywhere. Oid values remain set until 
replaced* The page number may be eliminated by specifying ///lineG 
or any out of range value* 

Any size header is permissible* It is also possible to supply 
folio information for pages by putting the page eject at some point 
after the first line of header material* Column one of the header 
information is assumed to contain printer control characters such as 
"blank's +• -* 0* etc* 

A great deal of flexibility is available for special page 
formats* 
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ki*o iA&Eaas-afltimsLaBS 



The following is a table of conversion performed by JABFORM : 



-A- 

-8xx»« b»»zz- 

-BBxx» .. .*zz- 

-C- 

-E- 

-F- 

-GxXf • • • f zz — 

-HN-Y.YC...C 

-IN- 

-JN- 

-KN- 

-L- 

-N- 

-Nx- 

-0- 

-P- 

-Q- 

-R- 

-SN- 

-T- 

-.TN- 

-U- 

-VXX» « ••#Z2- 

-VVxx* •• *fzz- 

-XN- 

-Z- 

— (MINUS MINUS) 

-ANY COMBINATIONS OF EDIT CODES- 



IlI£Q&fl 

XA 

\Bxx# •• • » zz 

XBBxx* ...jzz 

XC 

\E 

\F 

XGxx* ..*» zz 

XHN 

C » * • C 

\IN 

XJN 

XKN 

XL 

XM 

\Nx 

XO 

\P 

\Q 

\R 

VsN 

\T 

X.TN 

\U 

\Vxx» . . . * zz 

\ V x x $ * * • 9 z z 

XXN 

vz 
X 

XCOMBINATIQN OF CODES 
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♦ARABIC* 
♦AUTO* 
♦CAR01NXX+ 
♦ CHANGED* 
+OATE*XXXXXX 

♦DE^THXX* 

♦DOUBLE* 

*EIGHT+ 

*ENDT* 

*F01I0+XXXXXX 

*HEADA* 

♦HEADA*XX* 

♦HEADB* 

*HEADB»XX* 

*HEADC* 

*HEADC«XX* 

*JUST* 

♦LENGTHNN+ 



*LIST(X*.,.,X)*TITLE 



*HARGINXX* 

♦NOAUTO^ 

♦NOJUST+ 

♦NOPTAB* 

+NOSEQ+ 

*NOSOURCE* 

*PTAB* 

*RECORDXX*YY+ 



*ROMAN* 
♦ SEQ+ 



UllQ&B 

di scarded 
di scarded 
\RECORDlfXX 
\CHANG£#C 
\DATE 

As A jiffli A ins ri 

\FORMATf >XX 

\sPACE2 

d i scarded 

V (See *TABLE^) 

\F01IQ 

XXXXXX 

VHEADA 

\HEADA («XX discarded) 

\HEAD8 

VHEADB («XX discarded) 

VHEADC 

\HEADC ( = XX discarded) 

\just 

UENGTHNN 

(After this* JABFORM onty processes 
column 1 thru NN| NN^l to EOL is passed 
t h r u » ) 

\LISTX#**«#X 

TITLE 

(discards ?• and R*) 

\MARGINXX 

di scar ded 

\N04UST 

di scarded 

\NOSEQ 

di scarded 

di scarded 

\RECORDXX, YY 

(After this* 
columns XX thru 
and YY + 1 to EOL 

di scarded 

\sEQ 



JABFORM only processes 
YY; column 1 thru XX-1 
Mill be passed thru* ) 
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♦SETA^C 



♦SETC+C 
♦SETE+C 



♦SETQ+C 
♦SETS+C 
♦SETU+C 



♦SETTABlxXX,..*,15*ZZ+ 

♦SINGLE* 

♦ SIX + 

♦SOURCE^ 

♦SUBTITLE+XXXXXX 

♦TA8LE* 



the C as an edit 



♦TITIE+XXXXXX 

♦TODAY* 
*C 



•C.^.C* tapostrophies) 

% c • • * c $ 



mEcaa 

discarded 

(4ABFQRM recognizes the C as an 
alter code from now on.) 

discarded 

d i scar ded 

(JABFORH recognizes 
code from now on,} 

discarded 

IJA8FGRM recognizes the C as 
capitalize string code from now on») 

di scarfed 

CJABFORfi recognizes the C as the 
special character code from now on*) 

di scar ded 

(JA8F0RN recognizes the C as the 
underline string code from now on*) 

\sETTABlXXt...,15ZZ 

\sPACEl 

di scar ded 

d iscar ded 

\TITLE2 

XXXXXX 

\C0MMENT 

♦TABLED CInput thru next endt is 
processed* but passed to TXTFQRM as 
comment shifted to the right one 
space. ) 

+ENDT+ 

\ 

\TITLE1 

XXXXXX 

\T0DAY 

*C <C is not capitalized - ASCII 
6/12 TEXTJAB input does not use this 
feature*) 

C. . .C (capitalized) 

\UNDER 

C • • • C 

\U0FF 



not 
a 
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/A * (plus) 

/8 3 {closing bracket) 

/C * (single quote* grave accent? or closing quote) 

/O $ (dol lar si gn) 

/£ I (semicolon) 

/F > (greater than) 

/G < Cless than) 

/H ♦ (Plus) 

/I \BLANK1 

/J _ (under line) 

/K % (percent) 

/L (unknown - blank) 

/M £ (ampersand) 

/N ! (exclamation) 

/Q * (equal) 

/P * (asterisk) 

/Q 9 (commercial at) 

/R * (apostrophe or opening quote) 

/S - (minus) 

/T 2 (colon) 

/U # (pound) 

/V C (opening bracket) 

/V? ? (question) 

/X * (asterisk) 

/Y *• (quotation marks) 

/Z / (slant) 

/0 

/l 1 

/2 2 

/3 3 

M 4 

/5 5 

/6 6 

II 7 

/8 8 

/9 9 



CQNPANY PRIVATE 



Kl-5 

COC - SOFTWARE ENGINEERING SERVICES 

7/30/8 
SES (Release 17) User's Handbook REV? AB 



K1.0 JABFORN CONVERSIONS 



mma 


mEQ&a 


/ (space)C. .C 


\COMMENT 




C< 


» * C 


/* 


* 


( aster i sk) 


/« 


t 


(single quote* grave accent* or 


/- 


— 


(minus) 


/♦ 


♦ 


(plus ) 


/$ 


$ 


(dollar sign) 


It 


c 


(opening bracket) 


11 


1 


(cl osing bracket ) 


/" 


tt 


(quotation marks) 


Ilk 


+ 


(plus) 


11% 


> 


(closing brace) 


lit 


A 


(ci rcumf lex ) 


//D 


s 


(single quote* grave accent* or 


in 


• 


(apostrophe or opening quote) 


II? 


\ 


(reverse slant) 


IIG 


3 


(commercial at) 


IIH 


+ 


(pl us ) 


III 


(space) 


114 


♦ 


(plus ) 


UK 


• 
• 


(vertical 1 ine) 


III 


- 


(minus) 


i in 


* 


(vert leal i i ne) 


IIH 


*» 


(ti Ide) 


//O 


n 


(quotation marks) 


IIP 


(space) 


IIQ 


(space) 


//R 


(space) 


IIS 


(space) 


111 


(space) 


IIU 


+ 


(pl us) 


//V 


C 


(opening brace) 


//W 


* 


( aster i sk) 


in 


* 


(asterisk) 


in 


♦ 


(plus ) 


in 


\ 


(reverse slant) 


in 


/ 


(si ant) 


nt 


£ 


(ampersand) 


NOTES : 







closing quote) 



closing quote) 



1) If JA8F0RM Is passing columns* unprocessed data in the passed 
columns on input is in the same columns on output* Blank 
padding* when required* is done to accomplish this* 

2) All TXTFORM codes are put on a line by themselves. 
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31 All TEXTJAB codes Cexcept ♦TABLE*) that have no TXTFORM 
conversion is converted to EOL and a message sent to ERRFIIE. 

CAUTION t 

1) The TEXTJAB source XXX »YYY« converts to i 
XXX 

\UNDER 
YYY 
\UOFF 

Which lists as XXXYJCY.* To get a space before the first Y* the 
TXTFORH source must be changed to have a space before the Y. 

21 TXTFORM can oniy handle line length up thru 100 characters on 
output and TEXTJAB allows 120. This means the +LENGTH+ code 
Mill convert OK* but TXTFQRM will not process correctly. 

3) TXTFORM can only handle tab settings up thru 99 and TEXTJAB will 
handle 119» This means a TEXTJAB SETTA8 alter code will convert 
0K# but TXTFORtt wi I I not be able to handle it correctly. 

Example : 

♦SETTA37»103#8*113+ 

This will convert to s 

\sETTA871Q3»8113 - with tab number 71 and 81 with columns of 3 

and 13. 
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li.o aa&£ACi£E-S£i.iASL£.Lys£ii-ax.£aii^i 



The following table shows the ASCII characters and the internal 
octal codes that represent then? within the various character sets 
that are processed by the CQNV utility* 
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ASCII 
















ASCII4 




GRAPHIC 


N63 


N64 


N612 


N8E63 


N8E64 


N8E63A 


N8E64A 


ASCIIS 


N612i 


8 {COLON) 


63 


00 


072 


63 


00 


072 


072 


072 


7404 


A 


01 


01 


01 


01 


01 


101 


101 


101 


01 


B 


02 


02 


02 


02 


02 


102 


102 


102 


02 


C 


03 


03 


03 


03 


03 


103 


103 


103 


03 


D 


04 


04 


04 


04 


04 


104 


104 


104 


04 


E 


05 


05 


05 


05 


05 


105 


105 


105 


05 


F 


06 


06 


06 


06 


06 


106 


106 


106 


06 


G 


07 


07 


07 


07 


07 


107 


107 


107 


07 


H 


10 


10 


10 


10 


10 


110 


110 


110 


10 


I 


11 


11 


11 


11 


11 


111 


111 


111 


11 


J 


12 


12 


12 


12 


12 


112 


112 


112 


12 


K 


13 


13 


13 


13 


13 


113 


113 


113 


13 


L 


14 


14 


14 


14 


14 


114 


114 


114 


14 


M 


15 


15 


15 


15 


15 


115 


115 


115 


15 


N 


16 


16 


16 


16 


16 


116 


116 


116 


16 





17 


17 


17 


17 


17 


117 


117 


117 


17 


P 


20 


20 


20 


20 


20 


120 


120 


120 


20 


Q 


21 


21 


21 


21 


21 


121 


121 


121 


21 


R 


22 


22 


22 


22 


22 


122 


122 


122 


22 


S 


23 


23 


23 


23 


23 


123 


123 


123 


23 


T 


24 


24 


24 


24 


24 


124 


124 


124 


24 


U 


25 


25 


25 


25 


25 


125 


125 


125 


25 


V 


26 


26 


26 


26 


26 


126 


126 


126 


26 


w 


27 


27 


27 


27 


27 


127 


127 


127 


27 


X 


30 


30 


30 


30 


30 


130 


130 


130 


30 


Y 


31 


31 


31 


31 


31 


131 


131 


131 


31 


Z 


32 


32 


32 


32 


32 


132 


132 


132 


32 





33 


33 


33 


33 


33 


060 


060 


060 


33 


1 


34 


34 


34 


34 


34 


061 


061 


061 


34 


2 


35 


35 


35 


35 


35 


062 


062 


062 


35 


3 


36 


36 


36 


36 


36 


063 


063 


063 


36 


4 


37 


37 


37 


37 


37 


064 


064 


064 


37 


5 


40 


40 


40 


40 


40 


065 


065 


065 


40 


6 


41 


41 


41 


41 


41 


066 


066 


066 


41 


7 


42 


42 


42 


42 


42 


067 


067 


067 


42 


8 


43 


43 


43 


43 


43 


070 


070 


070 


43 


9 


44 


44 


44 


44 


44 


071 


071 


071 


44 
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ASCII 
















ASCII4 




GRAPHIC 


N63 


N64 


N612 


NBE63 


N8E64 


NBE63A 


N8E64A 


ASCII5 


N612 


♦ (PLUS) 


45 


45 


45 


45 


45 


053 


053 


053 


45 


- (MINUS) 


46 


46 


46 


46 


46 


055 


055 


055 


46 


* (ASTERISK 


47 


47 


47 


47 


47 


052 


052 


052 


47 


/ (SLASH) 


50 


50 


50 


50 


50 


057 


057 


057 


50 


{ (LEFT PAREN) 


51 


51 


51 


51 


51 


050 


050 


050 


51 


) (RIGHT PAREN) 


52 


52 


52 


52 


52 


051 


051 


051 


52 


$ (DOLLAR SIGN) 


53 


53 


53 


53 


53 


044 


044 


044 


53 


* (EQUAL) 


54 


54 


54 


54 


54 


075 


075 


075 


54 


(SPACE) 


55 


55 


55 


55 


55 


040 


040 


040 


55 


t (COMMA) 


56 


56 


56 


56 


56 


054 


054 


054 


56 


. (PERIOD) 


57 


57 


57 


57 


57 


056 


056 


056 


57 


# (POUND) 


60 


60 


60 


60 


60 


043 


043 


043 


60 


t (LEFT BRACKET) 


61 


61 


61 


61 


61 


133 


133 


133 


61 


3 (RIGHT BRACKET) 


62 


62 


62 


62 


62 


135 


135 


135 


62 


% (PERCENT) 


- 


63 


63 


- 


63 


- 


045 


045 


63 


M (DOUBLE QUOTE) 


64 


64 


64 


64 


64 


042 


042 


042 


64 


_ (UNDERLINE) 


65 


65 


65 


65 


65 


137 


137 


137 


65 


S (EXCLAMATION) 


66 


66 


66 


66 


66 


041 


041 


041 


66 


£ (AMPERSAND) 


67 


67 


67 


67 


67 


046 


046 


046 


67 


• (APOSTROPHE) 


70 


70 


70 


70 


70 


047 


047 


047 


70 


? (QUESTION) 


71 


71 


71 


71 


71 


077 


077 


077 


71 


< (LESS THAN) 


72 


72 


72 


72 


72 


074 


074 


074 


72 


> (GREATER THAN) 


73 


73 


73 


73 


73 


076 


076 


076 


73 


9 (COMMERCIAL AT) 


74 


74 


7401 


74 


74 


100 


100 


100 


7401 


\ (REV. SLASH) 


75 


75 


75 


75 


75 


134 


134 


134 


75 


A (CIRCUMFLEX) 


76 


76 


7402 


76 


76 


136 


136 


136 


7402 


; (SEMICOLON) 


77 


77 


77 


77 


77 


073 


073 


073 


77 



COMPANY PRIVATE 



Ul-2 



G SERVICES 




7/30/8 






Handbook 


REVS 


A8 










ASCII4 






4 N8E63A 


N8E64A 


ASCIIS 


N612U 


N6121 


072 


072 


072 


7404 


7404 


101 


101 


101 


01 


- 


102 


102 


102 


02 


.- 


103 


103 


103 


03 


— 


104 


104 


104 


04 


- 


105 


105 


105 


05 


- 


106 


106 


106 


06 


- 


107 


107 


107 


07 


- 


110 


110 


110 


10 


- 


111 


111 


111 


11 


— 


112 


112 


112 


12 


- 


113 


113 


113 


13 


— 


114 


114 


114 


14 


- 


115 


115 


115 


15 


- 


116 


116 


116 


16 


- 


117 


117 


117 


17 


- 


120 


120 


120 


20 


- 


121 


121 


121 


21 


- 


122 


122 


122 


22 


- 


123 


123 


123 


23 


- 


124 


124 


124 


24 


- 


125 


125 


125 


25 


- 


126 


126 


126 


26 


- 


127 


127 


127 


27 


— 


130 


130 


130 


30 


- 


131 


131 


131 


31 


- 


132 


132 


132 


32 


— 


060 


060 


060 


33 


33 


061 


061 


061 


34 


34 


062 


062 


062 


35 


35 


063 


063 


063 


36 


36 


064 


064 


064 


37 


37 


065 


065 


065 


40 


40 


066 


066 


066 


41 


41 


067 


067 


067 


42 


42 


070 


070 


070 


43 


43 


071 


071 


071 


44 


44 
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REVJ 


A8 










ASCII4 






4 N8E63A 


N8E64A 


ASCII5 


N612U 


N612! 


053 


053 


053 


45 


45 


05 5 


055 


055 


46 


46 


052 


052 


052 


47 


47 


057 


057 


057 


50 


50 


050 


050 


050 


51 


51 


051 


051 


051 


52 


52 


044 


044 


044 


53 


53 


075 


075 


075 


54 


54 


040 


040 


040 


55 


55 


054 


054 


054 


56 


56 


056 


056 


056 


57 


57 


043 


043 


043 


60 


60 


133 


133 


133 


61 


61 


135 


135 


135 


62 


62 


- 


045 


045 


63 


63 


042 


042 


042 


64 


64 


137 


137 


137 


65 


65 


041 


041 


041 


66 


66 


046 


046 


046 


67 


67 


047 


047 


047 


70 


70 


077 


077 


077 


71 


71 


074 


074 


074 


72 


72 


076 


076 


076 


73 


73 


100 


100 


100 


7401 


7401 


134 


134 


134 


75 


75 


136 


136 


136 


7402 


7402 


073 


073 


073 


77 


77 
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ASCII ASCII4 
GRAPHIC N63 N64 N612 NBE63 N8E64 NBE63A NBE64A ASCII5 N612U 

a 7601 141 

b 7602 142 

c 7603 143 

d 7604 144 

e 7605 145 

f 7606 146 

g 7607 147 

h 7610 150 

1 7611 151 

j 7612 152 

k 7613 153 

1 7614 154 
m 7615 155 
n 7616 156 
o 7617 157 
p 7620 160 
q 7621 161 
r 7622 162 
s 7623 163 
t 7624 164 
u 7625 165 
v 7626 166 
» 7627 167 
x 7630 170 
y 7631 171 

2 7632 172 
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ASCII4 

N8E63A N8E64A ASCIIS N612U M612L 

141 - 7601 

14? - 7602 

143 - 7603 

144 - 7604 

145 - 7605 

146 - 7606 

147 - 7607 

150 - 7610 

151 - 7611 

152 - 7612 

153 - 7613 

154 - 7614 

155 - 7615 

156 - 7616 

157 - 7617 

160 - 7620 

161 - 7621 

162 - 7622 

163 - 7623 

164 - 7624 

165 - 7625 

166 - 7626 

167 - 7627 

170 - 7630 

171 - 7631 

172 - 7632 
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ASCII 








GRAPHIC 




N63 


N64 M61< 


£ {LEFT BRACE) 


7633 


? {VERTICAL 


BAR) 


7634 


> (RIGHT 


BRACE) 


7635 


" {TILDE) 






7636 


DEL 






7637 


NUL 






7640 


SQH 






7641 


STX 






7642 


ETX 






7643 


EOT 






7644 


ENQ 






7645 


ACK 






7646 


BELL 






7647 


8S 






7650 


HT 






7651 


LF 






7652 


VT 






7653 


FF 






7654 


CR 






7655 


SO 






7656 


SI 






7657 


DLE 






7660 


DC1 






7661 


DC 2 






7662 


DC 3 






7663 


DC 4 






7664 


NAK 






7665 


SYN 






7666 


ETB 






7667 


CAN 






7670 


EM 






7671 


SUB 






7672 


ESC 






7673 


FS 






7674 


GS 






7675 


RS 






7676 


US 






7677 


• {GRAVE 


ACCENT) 


7407 



M612 NBE63 NBE64 





ASCII4 




BE63A N8E64A ASCII5 


N612J 




173 


7633 




174 


7634 




175 


7635 




176 


7636 




177 


7637 




000 


7640 




001 


7641 




002 


7642 




003 


7643 




004 


7644 




005 


7645 




006 


7646 




007 


7647 




010 


7650 




Oil 


7651 




012 


7652 




013 


7653 




014 


7654 




015 


7655 




016 


7656 




017 


7657 




020 


7660 




021 


7661 




022 


7662 




023 


7663 




024 


7664 




025 


7665 




026 


7666 




027 


7667 




030 


7670 




031 


7671 




032 


7672 




033 


7673 




034 


7674 




035 


7675 




036 


7676 




037 


7677 




140 


7407 
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ASCII4 






4 NBE63A NBE64A ASCIIS 


N612U 


N612 




173 


7633 


7633 




174 


7634 


7634 




175 


7635 


7635 




176 


7636 


76 36 




177 


7637 


7637 




000 


7640 


7640 




001 


7641 


7641 




002 


7642 


7642 




003 


7643 


7643 




004 


7644 


7644 




005 


7645 


7645 




006 


7646 


7646 




007 


7647 


7647 




010 


7650 


7650 




Oil 


7651 


7651 




012 


7652 


7652 




013 


7653 


7653 




014 


7654 


7654 




015 


7655 


7655 




016 


7656 


7656 




017 


7657 


7657 




020 


7660 


7660 




021 


7661 


7661 




022 


7662 


7662 




023 


7663 


7663 




024 


7664 


7664 




025 


7665 


7665 




026 


7666 


7666 




027 


7667 


7667 




030 


7670 


7670 




031 


7671 


7671 




032 


7672 


7672 




033 


7673 


7673 




034 


7674 


7674 




035 


7675 


7675 




036 


7676 


7676 




037 


7677 


7677 




140 


7407 


7407 
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H1.0 M£CaAtHSa-£flS-£QLLECIIIifi.US£&-SUE£LI£tt.SQEIMAR£ 



This mechanism defines when and how SES makes user developed 
software tools available to the entire SES user community* The 
mechanism is based on the assumption that it is beneficial to gather 
tools developed by people outside the SES organization into a 
common* known location* 



Hl.l QfiIAI!lItifi-USE&-SQEXtt&&E 

The user supplied software which is assembled and made available 
by SES falls into the area generally considered as "tools*** It is 
sufficiently general purpose so it is useful to people other than 
the originator* It is comprised of SES procedures* programs or 
modules* 

Software supplied by a user is totally transferable to another 
catalog* It is not dependent on any developer's catalog* or any 
catalog other than the one the tool itself resides in* If the 
software being supplied is a program or module* the source code is 
supplied* along with a build procedure that is also totally 
transferable to another catalog* The author can request the source 
remain unaccessible to other users* 

In addition to the actual software* the user submits the 
following documentation? 

A) A short description of the tool • which is kept in an online 
directory of user supplied tools along with the supplier's 
name* location and extension* 

B) Documentation on how to use the software* The more 
complete it is* the fewer phone calls the supplier 
receives* 

C) SES procedures contain HELP documentation that assist 
someone in using the procedure* 



n 1 . 2 ttAHIJafi.US£E-*ifl£IMA&£- A^AIUftLE-IUEQUfitt-SES 

When SES obtains user developed software* it is handled in a way 
similar to SES developed software* Procedures are collected on a 
procedure library called USSPLIB in the SES catalog* Binary files 
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are assigned USS numbered files* and are kept in the SES catalog* 
The source for user supplied software is collected onto a 
semi-private SCU PL called USSPL and kept in the SES catalog. If 
the author requests that it not be accessible* the source is kept in 
a private SES f i ie. 

The major advantage of maintaining user supplied software is the 
SES catalog is than any changes or new software are automatically 
sent to the sites receiving the regular SES updates. 



Ml. 3 CQdBUtiiaAII^- J I^ILAaiLIIX-Q£^ySE£.Sy££LI£a-iQ£IMAE£ 

An online directory (USSINFO) of user supplied tools is 
maintained on the SES catalog. This file contains a short 
description of the tool provided by the developer. This description 
is also circulated via the Advanced Systems Development Productivity 
Circle and/or the SES Tools Bulletin. 

Hard copy documentation supplied by the user is available from 
SES on request or online via TOQLDOC* 



Ml . 4 SUE£Q&I.a£.US£R-SUE£LI£Q.iQEIMARE 

All corrections* improvements or other modification to user 
supplied software are the responsibility of the person supplying the 
software. SES does not support any user supplied software. 

If software supplied by a user is standardized (it becomes a SES 
supported product) it is removed from the user supplied category. 



COMPANY PRIVATE 



Repi ace 


pages 


1 TO 


2 




Replace 


page 


1 






Replace 


pages 


3 TO 


7 




Repi ace 


pages 


1 TO 


3 




Replace 


pages 


5 TO 


6 




Repi ace 


pages 


1-15 


TO 


-31 


Insert 


page 


1-32 






Replace 


page 


3-19 






Replace 


page 


4-9 






Repi ace 


page 


4-12 






Repi ace 


page 


4-30 






Replace 


pages 


4-38 


TO 


-39 


Repi ace 


pages 


5-20 


TO 


-21 


Repi ace 


pages 


6-1 


TO - 


-2 


Replace 


pages 


6-15 


TO 


-17 


Replace 


pages 


6-19 


TO 


-22 


Insert 


pages 


6-23 


TO 


-24 


Repi ace 


pages 


8-3 


TO - 


-5 


Repi ace 


pages 


9-3 


TO - 


-5 


Replace 


page 


9-22 






Replace 


page 


13-5 






Repi ace 


pages 


14-25 


TO 


-27 


Rept ace 


pages 


15-2 


TO 


-5 


Replace 


pages 


17-1 


TO 


-9 


Replace 


pages 


17-11 


TO 


-12 


Insert 


pages 


17-13 


TO 


-14 


Repi ace 


page 


El-2 






Replace 


page 


Fl-1 






Repi ace 


page 


Hl-2 







CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES CRelease 17) User's Handbook REV* AB 



SOFTWARE ENGINEERING SERVICES 
Release 17 
USER'S HANDBOOK 



Author: £££ 

Subm i tted i H A «A*.£LSSiati£ll-. 



Approved: 



J* J* Krautbauer 
?m tf« Haynes 
J* W. Checco 



DISCLAIMER: 

This document Is an internal working paper only* It is subject to 
change and does not necessarily represent any official intent on the 
part of CDC. 



COMPANY PRIVATE 



CDC - SOFTWARE ENGINEERING SERVICES 
SES {Release 17) User's Handbook 



7/30/81 
REVS AB 



REVISION DEFINITION SHEET 



REV 



DATE 



DESCRIPTION 



U 



AA 
AB 



01/31/77 
04/15/77 
08/01/77 
02/06/78 
10/02/78 
05/29/79 



02/25/80 



07/30/80 



10/30/80 



03/30/81 
07/30/81 



Compl ete repr int. 

previous editions. 

Complete reprint, 

previous editions* 

Complete reprint, 

previous editions* 

Complete reprint, 

previ ous edi t i ons. 



Obsoletes al I 



Obsoletes all 



Obsoletes all 



Obso I etes al I 



Complete reorganization and reprint* 
Obsoletes all previous editions* 

Major update for SES Release 12. 
Includes descriptions of new 
procedures* updates and corrections to 
old ones* and minor reorganization. 

Major update for SES Release 13* 
Includes descriptions of new 
procedures* updates and corrections to 
old ones* and minor reorganization. 

Update for SES Release 14. Includes 
descriptions of new procedures 
(specifically the NOS-170 SCU)» updates 
and corrections to old procedures* and 
minor reorganization* 

Update for SES Release 15. Includes 
descriptions of new procedures 
(specifically CADS)* updates and 
corrections to old procedures. 

Update for SES Release 16. 

Update for SES Release 17. 



c 1981 

by Control Oata Corporation 



COMPANY PRIVATE 



7/30/81 



Table of Contents 



1.0 INTRODUCTION . . . . . 

1.1 USING AN SES PROCEDURE 

1.2 PARAMETERS FOR SES PRO 

1.2.1 TYPES OF PARAMETER 

1.2. 1.1 Names as Param 

1.2.1.2 Numbers as Par 
1.2*1.3 Character Stri 

1.2.2 RANGES OF PARAMETE 

1.2.3 LISTS OF VALUES FO 

1.2.4 PARAMETER LISTS AS 

1.2.5 PARAMETER KEYWORDS 

3 USING MORE THAN ONE SE 

4 ORDINARY CONTROL STATE 

5 CONTINUING SES STATEME 

6 PROFILE - SETTING UP Y 

7 SES PROCEDURES RUN AS 
1.7.1 PROFILE VARIABLES 

8 INF3RMATIVE MESSAGES F 

9 GENERAL NOTES ON SES P 
ACQUIRING Fi I es in SES 
Using SES Procedures i 
Unique Names in SES pr 

10 PROCEDURE DESCRIPTION 

11 HELP MODE ...... 

12 PRE-RELEASE VERSIONS 

13 PROBLEM REPORTING . . 

14 APPLICABLE DOCUMENTS 



1. 
1. 
1. 
1. 
1. 

1. 
1. 



1. 
1. 
1. 
1. 
1. 



CEDURES 
VALUES 
eter Valu 
araeter Va 
ngs as Pa 
R VALUES 
R PARAMET 
PARAMETE 
AS PRQCE 
S PROCEDU 
MENTS ON 
NTS OVER 
OUR LOCAL 
BATCH JOB 
FOR CONTR 
ROM SES P 
ROCEDURES 
Procedur 
n Batch 
ocedures 
CQNVENTI 

OF TOOLS 



es * * 
lues . 
r aweter 

. . . . 
E R S . * 
R VALUE 
DURE OP 
RE AT A 
A CALL 
MORE TH 
ENVIRO 
S . • * 
OLLING 
ROCEDUR 



• . • . 



Values . 

..... 

..... 
5 .... 
TIONS . . 

TIME . . 
TO SES . . 
AN ONE LINE 



NMENT . . 

..... 
BATCH MODE 
E S . • * * 



es 



ONS . * 



2.0 
2.1 

2.2 

2.3 
2.4 



3.0 
3.1 

3.2 

3.3 
3.4 
3.5 
3.6 
3.7 
3.8 
3.9 



PRINTING FILES ....... 

PRINT - PRINT FILE(S) . . . 

PROFILE Variables for PRINT 

PRINTID - PRINT "LARGE PRINT" 

PROFILE Variables for PRINTID 

CQPYSAF - COPY SHIFTED ASCII FILE TO PREPARE FOR PRINTER 

BANNER - WRITE BIN NUMBER ON LARGE PRINT BANNER PAGE 

PROFILE Variables for BANNER • •••...*•••• 



HEADING BANNERS 



DOCUMENT F 
FORMAT - R 
Data Flow 
FORMREV - 
Data flow 
SPELL - CH 
TWOPAGE - 
DIAGRAM - 
MEMO - GEN 
TXTCODE - 
TXTFORM - 
TXTHEAD - 



ORMATTING SYSTEM • ••••••.••.•.. 

UN DOCUMENT FORMATTING SYSTEM ....... 

of FORMAT Procedures ..*•*••••.•• 

FORMAT A REVISION PACKAGE FROM DOCUMENT SQURC 
of FORMREV Procedures • ••••.•.••• 

ECK FILE FOR SPELLING MISTAKES ....... 

PRINT TWO DOCUMENT PAGES SIDE BY SIDE . . . 
DIAGRAM DRAWING AID ............ 

ERATE STANDARD MEMO HEADER ....••••• 

RUN TXTCODE DOCUMENT PREPROCESSOR ..... 

RUN TXTFORM DOCUMENT PROCESSOR . 

PAGE HEADING PROCESSOR ........... 



1-1 

1-4 

1-4 

1-7 

1-7 

1-7 

1-8 

1-9 

1-10 

1-12 

1-12 

1-13 

1-13 

1-14 

1-15 

1-17 

1-21 

1-23 

1-24 

1-25 

1-26 

1-26 

1-27 

1-28 

1-29 

1-30 

1-31 

2-1 

2-2 

2-6 

2-7 

2-9 

2-10 

2-13 

2-14 

3-1 
3-3 
3-8 
3-11 
3-14 
3-17 
3-19 
3-21 
3-23 
3-26 
3-27 
3-28 



3 
7/30/81 

6.5 PERMIT - OBTAIN FULL LIST OF PERMISSION INFORMATION , . 6-9 

6.6 LIMITS - DISPLAY VALIDATION LIMITS ........... 6-10 

6.7 TIME - DISPLAY CURRENT TIME OF DAY ........... 6-11 

6.8 DISPLAY - DISPLAY VARIOUS USEFUL INFORMATION ...... 6-12 

6.9 DAYWEEK - DISPLAY DAY OF THE WEEK • •.••.••.•• 6-14 

6.10 TOOLDQC - PRINT TOOL DOCUMENT ............. 6-15 

6.11 TOQLREP - LIST TOOL REPORT • ••.•••....... 6-17 

6.12 INFO - ACCESS SES INFORMATION .,...,•••,•• , 6-18 

6.13 USSDGC - SET USER SUPPLIED SOFTWARE DOCUMENT ..... 6-19 

6.14 USSINFO - ACCESS USS INFORMATION ........... 6-20 

6.15 SESPRQC - LIST SES PROCEDURE NAMES • ••.••.••• 6-21 

6.16 SESPARM - PRINT PARAMETER REQUIREMENTS FOR SES PROCS . 6-22 

7.0 FILESPACE MANAGEMENT .................. 7-1 

7.1 RETAIN - ACCESS ALL FILES IN USER'S CATALOG ...... 7-2 

7.2 DUMPPF / LOADPF - DUMP / LOAD PERMANENT FILES ..... 7-3 

7.3 REWRITE - REWRITE FILE ....•.••.*.*•...* 7-7 

8.0 COMPILING* LINKING* AND DEBUGGING ........... 8-1 

8.1 CYBIL - RUN CYBIL CC OR CYBIL CI COMPILER ....... 8-2 

8.2 ISWL - RUN ISWL CC COMPILER ••....••••••.• 8-6 

8.3 SYMPL - RUN THE SYMPL COMPILER ............. 8-8 

8.4 FTN - RUN THE FTN (FORTRAN EXTENDED) COMPILER ..... 8-10 

8.5 FTN5 - RUN THE FTN5 CFORTRAN-5) COMPILER ...••*.. 8-12 

8.6 COMPASS - RUN THE COMPASS ASSEMBLER •••••••••• 8-14 

8.7 CPAS180 - RUN THE CPU ASSEMBLER FOR THE CYBER 180 ... 8-16 

8.8 PPAS180 - RUN THE PPU ASSEMBLER FOR THE CYBER 180 . . . 8-18 

8.9 LINK170 - LINK RELOCATABLE BINARIES .......... 8-20 

8.10 GETCCD8 - GET CYBIL INTERACTIVE DEBUG ......... 8-24 

8.11 GETLIB OR GETLI9S - ACQUIRE LIBRARY FOR LINKING .... 8-25 

9.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION . 9-1 

9.1 SIM180 - RUN THE CYBER 180 HARDWARE SYSTEM SIMULATOR . . 9-3 

9.2 T0180 - NOS/170 TO SIMULATED NOS/VE FILE CONVERSION . . 9-6 

9.3 T0170 - NOS/170 TO NOS/170 INTERFACE FILE CONVERSION . . 9-7 

9.4 FR0M180 - SIMULATED NOS/VE TO NOS/170 FILE CONVERSION . 9-8 

9.5 FR0M170 - NOS/170 INTERFACE TO NOS/170 FILE CONVERSION . 9-9 

9.6 DUMP180 - SIMULATED NOS/VE FILE DUMP ••.•••••.. 9-10 

9.7 DUMP170 - NOS/170 INTERFACE FILE DUMP ..•••••.. 9-11 

9.8 GENCPF - GENERATE A CHECKPOINT FILE (CPF) 9-12 

9.9 VELINK - EXECUTE THE VIRTUAL ENVIRONMENT LINKER .... 9-15 

9.10 VEGEN - EXECUTE THE SES VIRTUAL ENVIRONMENT GENERATOR . 9-18 

9.11 GETLIB OR GETLIBS - ACQUIRE LIBRARY FOR LINKING .... 9-20 

9.12 GETDSI - ACQUIRE BINARY FOR DEADSTART TAPE GENERATOR . 9-21 

9.13 GETLDB - ACQUIRE BINARY FOR ENVIR. INT. LOADER .... 9-22 

10.0 SOURCE CODE UTILITY ON NOS 170 ............ 10-1 

10.1 SCU - ACQUIRE EXECUTABLE BINARY FOR SCU ........ 10-2 

10.2 SOLO - STAND ALONE SCU EDITOR ..••...••••.. 10-3 

10.3 SCUCOMP - GENERATE SCU CORRECTION SET ........ . 10-4 

11.0 CYBER 180 OBJECT CODE UTILITIES ............ 11-1 

Parameter Naming Convention for Object Code Utilities . 11-2 

PROFILE Variables for Object Code Utilities ...... 11-3 



11.1 

11.2 
11.3 
11.4 
11.5 

12.0 
1 Z . 1 
12.2 
12.3 
12.4 



Interlock Process for Updating a library 
COM - CHANGE OBJECT MODULE ...... 

DEQM - DELETE OBJECT MODULEtSJ .... 

DION - DISPLAY OBJECT MODULE INFORMATION 
GOL - GENERATE OBJECT LIBRARY ..... 

GOF - GENERATE OBJECT FILE ...... 



SOURCE TEXT PREPROCESSORS ......... 

CY8FQRM - CYBIL SOURCE TEXT REFQRMATTER . . 
ISWLFRM - ISWL SOURCE TEXT REFQRMATTER . . 
PSEUDO - RUN PSEUDQ PREPROCESSOR . . . . . 

F5F0RM - FORTRAN 5 SOURCE TEXT REFORHATTER. 



13. 



13. 

13. 

13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 
13. 



SES COMMUNICATIONS . 
User to User Comwunica 
Remote Mainframe Comrau 

1 SEND - TRANSMIT FILES 

2 MAIL - SEND MAIL TO 
MAIL Addressees who do 



GETMAIL 
NEWMAIL 
ANYMAIL 
WHOMAIL 
SAVMAIL 
CHKMAIL 



DISPLAY MAI 
CREATE A NE 
COUNT NUMBE 
DISPLAY LIS 
SAVE MAIL80 
CHECK YOUR 



9 SUBMIT - SUBMIT A JOB 

10 GETPF - GET A PERMAN 

11 SENDPF - SEND A PERM 

12 CHANGPF - CHANGE PAR 

13 PURGPF - REMOVE (PUR 

14 PERMPF - PERMIT ACCE 

15 CATPF - DISPLAYS INF 

16 DISPOSE - PRINT A FI 
Alphabetical Summary o 



t i o n s . . . * . . 
nications .... 

BETWEEN NOS SITES 
THER USERS .... 

not have a MAILBOX 
L FROM MAILBOX . . 
W MAILBOX / CLEAR E 
R OF ITEMS IN MAILS 
T OF USERS WHO HAVE 
X . * . « . . * * 
MAILBOX • • • . • 

TO BE PROCESSED AT 
ENT FILE FROM A REM 
ANENT FILE TO A REM 
AMETERS OF A PERMAN 
GE) A PERMANENT FIL 
SS TO A PERMANENT F 
ORMATION ABOUT A FI 
LE AT A REMOTE SITE 
f Remote Link Proce 



XISTING MAILBO 

OX ..... 
SENT MAIL . 



A REMOTE SITE 
OTE SITE . . 
OTE SITE . . 
ENT FILE . . 

t ..... . 

I L E * * . . . 
L E ..... 

. .... * 

dures .... 



14.0 

14.1 

14.2 

14.3 

14.4 

14.5 

14.6 

14,7 

14.8 

14.9 

14.10 

14.11 

14.12 

14.13 

14.14 

14.15 

14.16 

14.17 

14.18 



EXT MANI 
DT - RUN 
OWTOUP - 
PTOLOW - 
OPYACR - 
SORT - S 
NIQUE - 
ERGE - M 
EMERGE - 
QMPARE - 
COUNT - 
SELECT - 
MULTED - 
PACK - P 
UNPACK - 
C3NV - C 
JABFORM 
SNOBOL - 
FIND - F 



PULATION AND 

THE EOT TEX 

CONVERT LOW 

CONVERT UPP 

COPY ASCII 

ORT ASCII FI 

REMOVE ADJAC 

ERGE UP TO F 

SPLIT FILE 

COMPARE TEX 

COUNT THINGS 

COPY SELECT 

EDIT MULTI 

ACK MULTI RE 

UNPACK TEXT 

ONVERT CHARA 

- CONVERT TE 

8-BIT SN08Q 

1ND PATTERNS 



CONVERSION UTILITIES .... 
T EDITOR . 

ER CASE TO UPPER CASE .... 

ER CASE TO LOWER CASE .... 

CODED RECORDCS) ....... 

L c 5 ............. 

ENT DUPLICATE LINES FROM A FILE 
IVE FILES INTO ONE FILE . . . 
APART BY COLUMNS ....... 

T FILES ........... 

IN A FILE • • • • • 

ED LINE RANGES FROM A FILE . . 
RECORD FILE • •..•••.. 
CORD FILE . . . . . . . . . . 

FILE TO MULTI RECORD FILE . . 
CTER SET .......... . 

XTJAB SOURCE TO TXTFORM SOURCE 
L INTERPRETER ........ 

INAF I LE ..*•••...• 



30/81 


11 


-4 


11 


-6 


11- 


10 


11- 


13 


11- 


15 


11- 


19 


12 


-1 


12 


-2 


12 


-3 


12 


-5 


12 


-6 


13 


-1 


13 


-1 


13 


-4 


13 


-6 


13 


-8 


13 


-8 


13- 


10 


13- 


11 


13- 


12 


13- 


13 


13- 


14 


13- 


15 


13- 


16 


13- 


17 


13- 


18 


13- 


19 


13- 


20 


13- 


21 


13- 


22 


13- 


23 


13- 


24 


14 


-1 


14 


-3 


14 


-4 


14 


-5 


14 


-6 


14 


-8 


14- 


11 


14- 


13 


14- 


14 


14- 


15 


14- 


17 


14- 


19 


14- 


21 


14- 


23 


14- 


24 


14- 


25 


14- 


27 


14- 


28 


14- 


29 



Text Patterns and Regular Expressions • ••**.. 

Summary of Regular Expressions • * * • • • • • • * • 

14*19 CHANGE - CHANGE LINES THAT MATCH SPECIFIED PATTERNS 
14.20 XLIT - TRANSLITERATE CHARACTERS ......... 

Summary of XLIT Capabilities • ».....••*•• 

15.0 MISCELLANEOUS USEFUL GOODIES ........... 

15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS ... 

15.2 OBJLIST - LIST CYBER 180 OBJECT TEXT ....... 

15.3 DO - CONTROL STATEMENT GENERATOR ......... 

15.4 MATH - INTERACTIVE KEYBOARD CALCULATOR ...... 

15.5 BELL - ATTENTION GETTER OR WAKE UP ........ 

15.6 BYE — LOG OUT *•*...*.•*****.*.*• 

15.7 HEXDMP - GENERATE HEXADECIMAL DUMP ........ 

15.8 CONCAT - CONCATENATE FILES ............ 

15.9 SCATTER - SCATTER A MULTI RECORD FILE TO OTHER FILES 

16.0 HANDLING UPDATE PROGRAM LIBRARIES ...... 

PROFILE Variable for UPDATE Facilities .... 

Working with the UPDATE Procedures •••••* 

16.1 GENUPCF - GENERATE UPDATE COMPILE FILE . . . 

16.2 GETDECK - GET DECK(S) FOR EDITING ...... 

16.3 GENM0DCS1 - GENERATE MODSETS FOR UPDATE . . . 

16.4 GENUPSF - GENERATE UPDATE SOURCE FILE .... 

16.5 UPDATE - UPDATE PROGRAM LIBRARY WITH CORRECTION SET(S) 



BLOCKS 



17.0 STRUCTURED PROCESS TOOLS ....... 

CADS - COMPUTER AIDED DESIGN OF SOFTWARE 

17.1 CADSG - CREATE OR UPDATE SASD DIAGRAMS 

17.2 CADSGUT - LIST OR EDIT DIAGRAM TITLE 

17.3 DDCREAT - CREATE A DATA DICTIONARY . . . 

17.4 DDDIS - DISPLAY A DATA DICTIONARY .... 

17.5 DDMERGE - MERGE TWO DATA DICTIONARIES . . 

17.6 DDXREF - CROSS REFERENCE A DATA DICTIONARY 

17.7 DDXCHK - CHECK A DATA DICTIONARY FOR CONSISTENCY 



7/30/81 


14- 


30 


14- 


33 


14- 


35 


14- 


37 


14- 


38 


15 


-1 


15 


-2 


15 


-7 


15 


-8 


15- 


10 


15- 


11 


15- 


12 


15- 


13 


15- 


14 


15- 


15 


16 


-1 


16 


-2 


16 


-3 


16 


-6 


16 


-9 


16- 


12 


16- 


14 


16- 


17 


17 


-1 


17 


-1 


17 


-3 


17 


-5 


17 


-6 


17 


-7 


17 


-9 


17- 


11 


17- 


13 



APPENDIX A PROFILES ................... Al 

A1.0 PROFILES • ,••..•.••.•••••••••••• Al-1 

Al.0.1 SEARCH DIRECTIVE - ESTABLISH LIBRARY SEARCH ORDER . Al-2 

Al.l LOCATING A PROCEDURE • .••••.••••••.... Al-3 

Al.1.1 DEFAULT ORDER OF SEARCH .............. Al-4 

Al.l. 2 SEARCH SPECIFIED ON CONTROL STATEMENT ....... Al-4 

Al.l. 3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTIVES . . . Al-5 



APPENDIX B Operating Modes of the SES Processor 



..... 



B1.0 OPERATING MODES OF THE SES PROCESSOR 
Bl.l SELECTING MODE OF OPERATION .... 



Bl 

Bl-1 
Bl-2 



APPENDIX C 



Error and Informative Messages 



........ 



CI 



6 
7/30/81 



C1.0 ERROR AND INFORMATIVE MESSAGES ............ Cl-1 

CX*I. SYNTAX ERRORS * . * » . * • * • • » . • • * . . * * * . Cl—1 

CI. 2 PROCEDURE ORGANIZATION ERRORS ............. Cl-5 

CI. 3 FILE USAGE ERROR MESSAGES ............... Cl-6 

CI. 4 INTERNAL ERROR MESSAGES ................ Cl-6 

CI. 5 INFORMATIVE MESSAGES AND PROMPTS ........... Cl-7 

APPENDIX D SYNTAX .................... Dl 

D1.0 SEMI-FORMAL SYNTAX DESCRIPTION ..,..••..... Dl-1 

01.1 THE META LANGUAGE ..•..•..••......••• Dl-1 

D 1.2 CHARACTER SET . * * * • . . • « • • . • • • . . . * • • D 1 — 3 

D1.3 SYNTAX «**.***«**«*.**«.*.*.**« D 1 — 5 

01,3.1 BASIC DEFINITIONS ........... Dl-5 

D 1 . 3 . 2 T K E N 5 • . • . * • * . * . • • • . * * * • • * . * D 1 — 5 

Dl.3.3 USE OF SPACES • •..••....••••*••.• Dl-8 

Dl.3.4 EXPRESSIONS .................... Dl-10 

Dl.3.5 FOREIGN TEXT ................... Dl-11 

Dl.3.6 PARAMETER LISTS .................. Dl-13 

Dl.3.7 SES PROCESSOR CALL ..••...•.•.••••• Dl-14 

01.3.8 SUBSTITUTION ................... Dl-15 

Dl.3.9 PROCEDURES • ••*•••••...•.*••••• Dl-16 

Dl.3.10 DIRECTIVES .................... Dl-17 

01.4 LINES AND THEIR CONTINUATION • •...•.....•• Dl-18 

APPENDIX E ACQUIRE Utility ................ El 

E1.0 ACQUIRE UTILITY .................... El-1 

APPENDIX F EDT - Enhanced Version of NOS Text EDITor ... Fl 

F1.0 EDT - ENHANCED VERSION OF NQS TEXT EDITOR ....... Fl-1 

Fl.l EDT CONTROL STATEMENT FORMAT ............. Fl-1 

APPENDIX G EXTRACT Utility ............... . Gl 

G1.0 EXTRACT UTILITY ..••••.*•.•••• Gl-1 

APPENDIX H SESMSG Utility ................ HI 

H1.0 SESMSG UTILITY ••••••••••••...••.•• Hl-1 

Appendix I JOBID - Produce Large Print Banner ...... II 

II. JOBID - PRODUCE LARGE PRINT BANNER *•••....•• 11-1 



7 
7/30/81 

Appendix J TXTHEAD Document (Headings) Post-Processor * • Jl 

J1.0 TXTHEAO DOCUMENT (HEADINGS) POST-PROCESSOR ...... Jl-1 

Appendix K JA8F0RM Conversions • ••...••.**•.• Kl 

K1.0 JA3F0RH CONVERSIONS .................. Kl-1 

Appendix L Character Set Table (used by CONV) ..».*• LI 

L1.0 CHARACTER SET TABLE (USED BY CONV) .......... Ll-1 

APPENDIX M User Supplied Software ............ Ml 

M1.0 MECHANISM FOR COLLECTING USER SUPPLIED SOFTWARE . . . . Ml-1 

Ml.l OBTAINING USER SOFTWARE ................ Ml-1 

Ml. 2 MAKING USER SOFTWARE AVAILABLE THROUGH SES ...... Ml-1 

Ml. 3 COMMUNICATING AVAILABILITY OF USER SUPPLIED SOFTWARE . Ml-2 

Ml. 4 SUPPORT OF USER SUPPLIED SOFTWARE ..••.•••••• Ml-2 



Alphabetical Table of Contents 



13.5 ANYMAIL - COUNT NUMBER OF ITEMS IN MAILBOX 
14.5 ASQRT - SORT ASCII FILES ....... 



*•**•• 13—12 
...... 14—8 



2.4 BANNER 

15.5 SELL 

15.6 BYE 



VIRITE BIN 
ATTENTION 
LOG OUT . 



NUMBER ON LARGE PRINT 
GETTER OR WAKE UP 



BANNER PAGE 



2-13 

15-11 

15-12 



17.1 

17.2 

6.3 

4.8 

5.5 

6.1 

13.15 

14.19 

13.12 

13.8 

4.3 

5.4 

11.1 

14.9 

8.6 

15.8 

14.15 

14.4 

2.3 

14.10 

8.7 

12.1 

8.1 



CAOSG 

CADSGUT 

CATALOG 

CAT8ASE 

CATLI8 

CATLIST 

CATPF 

CHANGE 

CHANGPF 

CHKMAIL 

COLLECT 

COLLECT 

COM 

COMPARE 

COMPASS 

CONCAT 

CONV 

COPYACR 

COPYSAF 

COUNT 

CPAS180 

CY8F0RM 

CY8IL 



CREATE OR 
LIST OR ED 
SHOW LIST 
PRODUCE LI 
PRODUCE LI 
DISPLAY PE 
DISPLAYS I 
CHANGE LIN 
CHANGE PAR 
CHECK YOUR 
COLLECT MO 
COLLECT ME 
CHANGE OBJ 
COMPARE TE 
RUN THE CO 
CONCATENAT 
CONVERT CH 
COPY ASCII 
COPY SHIFT 
COUNT THIN 
RUN THE CP 
CYBIL SOUR 
RUN CYBIL 



UPDATE SASD 
IT DIAGRAM T 
OF RECORDS I 
ST OF MODULE 
ST OF MEMBER 
RMANENT FILE 
NFORMATION A 
ES THAT MATC 
AMETERS OF A 

MAILBOX . 
DULE(S) TO 8 
MBER(S) TO B 
ECT MODULE 
XT FILES . 
MPASS ASSEMB 
E FILES 
ARACTER SET 

CODED RECOR 
ED ASCII FIL 
GS IN A FILE 
U ASSEMBLER 
CE TEXT REFO 
CC OR CYBIL 



DIAG 
ITLE 
N A 
S IN 
S IN 

INF 
BOUT 
H SP 

PER 
. . 
UILD 
UILD 



* * 
L£R 



RAMS * . . * . 
B L OC K S * • * * 

FILE ..... 
A BASE LIBRARY 
A LIBRARY . . 

ORMATION . . . 
A FILE . . . 

SCIFIED PATTERNS 

MANENT FILE 

........ 

A GROUP FILE 
A GROUP FILE 



* . 

* . 

* « 

* . 



D(S) 

E TO 

. 
FOR 
RMAT 
CI C 



....... 

PREPARE FOR PRINTER 
.......... 

THE CYBER 180 . . 
TER ....... . 

OMPILER ..... 



17-3 

17-5 

6-6 

4-36 

5-18 

6-3 

13-22 

14-35 

13-19 

13-15 

4-20 

5-16 

11-6 

14-15 

8-14 

15-14 

14-25 

14-6 

2-10 

14-17 

8-16 

12-2 

8-2 



6.2 

6.9 

17.3 

17.4 

17,5 

17*7 

17,6 

14.8 

11.2 

3.5 

11.3 

6.8 

13.16 

15.3 

9.7 

9.6 

7.2 



DAYFILE 

DAYWEEK 

DDCREAT 

OODIS 

DDMERGE 

ODXCHK 

DOXREF 

OEMERGE 

DEOM 

DIAGRAM 

OIOM 

DISPLAY 

DISPOSE 

DO 

DUMP170 

DUMP180 

DUMPPF 



OF DAYFILE 



14.1 EOT 



- DISPLAY SELECTED PORTIONS 

- DISPLAY DAY OF THE WEEK ,....•••.. 

- CREATE A DATA DICTIONARY .......... 

- DISPLAY A DATA DICTIONARY .......... 

- MERGE TWO DATA DICTIONARIES ......... 

- CHECK A DATA DICTIONARY FOR CONSISTENCY . * 

- CROSS REFERENCE A DATA DICTIONARY . . . . . 

- SPLIT FILE APART BY COLUMNS ••••....• 

- DELETE OBJECT MQDULECS) .......... 

- DIAGRAM DRAyiNG AID ............ 

- DISPLAY OBJECT MODULE INFORMATION . . . . . 

- DISPLAY VARIOUS USEFUL INFORMATION . . . . . 

- PRINT A FILE AT A REMOTE SITE ....... 

- CONTROL STATEMENT GENERATOR ........ 

- NOS/170 INTERFACE FILE DUMP ........ 

- SIMULATED NOS/VE FILE DUMP ......... 

/ LQADPF - DUMP / LOAD PERMANENT FILES . . . . 

- RUN THE EDT TEXT EDITOR ••••.....»• 



6-5 

6-14 

17-6 

17-7 

17-9 

17-13 

17-11 

14-14 

11-10 

3-21 

11-13 

6-12 

13-23 

15-8 

9-11 

9-10 

7-3 

14-3 



12.4 


F5F0RM 


6.4 


FILES 


14.18 


FIND 


3.1 


FORMAT 


3.2 


FORMREV 


9.5 


FRQM170 


9.4 


FR0M180 


8.4 


FTN 


8.5 


FTN5 



FORTRAN 5 SOURCE TEXT REFORMATTER ...... 12-6 

DISPLAY LOCAL FILE INFORMATION ....... 6-8 

FIND PATTERNS IN A FILE ........... 14-29 

RUN DOCUMENT FORMATTING SYSTEM ....... 3-3 

FORMAT A REVISION PACKAGE FROM DOCUMENT SOURCE 3-11 

NQS/170 INTERFACE TO NOS/170 FILE CONVERSION 9-9 

SIMULATED NOS/VE TO NOS/170 FILE CONVERSION 9-8 

RUN THE FTN (FORTRAN EXTENDED) COMPILER . . 8-10 

RUN THE FTN5 (FORTRAN-5) COMPILER ...... 8-12 



4.4 GENCQMP - GENERATE COMPILE FILE FOR MODULE(S) . , . . 4-23 

4.5 GENCQR OR GENCQR5 - GENERATE CORRECTION SETS ..... 4-29 
9.8 GENCPF - GENERATE A CHECKPOINT FILE <CPF) ...... 9-12 

16.3 GENMODCS) - GENERATE MODSETS FOR UPDATE ........ 16-12 

3.10 GENREVB - GENERATE REVISION BARS FOR DOCUMENTS .... 3-29 

3.11 GENREVP - GENERATE A REVISION PACKAGE FOR A DOCUMENT . 3-31 

16.1 GENUPCF - GENERATE UPDATE COMPILE FILE ........ 16-6 

16.4 GENUPSF - GENERATE UPDATE SOURCE FILE ......... 16-14 

8.10 GETCCD8 - GET CT8IL INTERACTIVE DEBUG ......... 8-24 

4.13 GETCQMN - ACQUIRE CYBIL COMMON DECK LIBRARY ...... 4-48 

16.2 GETDECK - GET DECK(S) FOR EDITING ••••.,•••.. 16-9 

9.12 GETDSI - ACQUIRE BINARY FOR DEADSTART TAPE GENERATOR 9-21 

9.13 GETLD8 - ACQUIRE BINARY FOR ENVIR. INT . LOADER . . . 9-22 

8.11 GETLI8 OR GETLIBS - ACQUIRE LIBRARY FOR LINKING . . . 8-25 

9.11 GETLI8 OR GETLIBS - ACQUIRE LIBRARY FOR LINKING . . . 9-20 

13.3 GETMAIL - DISPLAY MAIL FROM MAILBOX .....,..*. 13-10 
5.1 GETMEM OR GETMEMS - EXTRACT MEMBER(S) FROM LIBRARY . . 5-8 

4.1 GETMQD OR GETMQDS - EXTRACT MODULE GROUP FROM BASE . . 4-11 
13.10 GETPF - GET A PERMANENT FILE FROM A REMOTE SITE . . 13-17 

11.5 GOF - GENERATE OBJECT FILE ..••••...,•• 11-19 

11.4 GQL - GENERATE OBJECT LIBRARY .......... . 11-15 

15.7 HEXDMP - GENERATE HEXADECIMAL DUMP ......... 15-13 

15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS . . . 15-2 

6.12 INFO - ACCESS SES INFORMATION ........... 6-18 

8.2 ISUl - RUN ISWL CC COMPILER ............ 8-6 

12.2 ISWLFRM - ISWL SOURCE TEXT REFORMATTER ........ 12-3 



5.2 REPMEM OR REPMEMS - ADD OR REPLACE HERBERTS) ON LIBRARY 5-10 

4.2 REPMOD OR REPMODS - ADD OR REPLACE MODULES ...... 4-15 

5.3 REPULIB - ADD OR REPLACE MEMBERCS) ON USER LIBRARY . * 5-13 
7,1 RETAIN - ACCESS ALL FILES IN USER'S CATALOG . . . . . 7-2 
7*3 REWRITE — REWRITE FILE * • * • • * • * * * * * » • * * 7— "7 



13.7 

15.9 

10.1 

10.3 

14.11 

13.1 

13.11 

6.16 

6.15 

9.1 

14.17 

10.2 

5.7 

4.10 

3.3 

5.8 

13.9 

8.3 



SAVMAIL 

SCATTER 

SCU 

SCUCQMP 

SELECT 

SEND 

SENDPF 

SESPARM 

SESPROC 

SIM180 

SNOBOL 

SOLO 

SQRTMEM 

SORTMOD 

SPELL 

SRTULIB 

SUBMIT 

SYMPL 



SAVE MAILB 
SCATTER A 
ACQUIRE EX 
GENERATE S 
COPY SELEC 
TRANSMIT F 
SEND A PER 
PRINT PARA 
LIST SES P 
RUN THE CY 
8-BIT SNOB 
STAND ALON 
SORT LIBRA 
SORT BASE 
CHECK FILE 
SORT USER 
SUBMIT A J 
RUN THE SY 



OX . . 
MULTI RE 
ECUTABLE 
CU CORRE 
TED LINE 
ILES BET 
MANENT F 
METER RE 
ROCEDURE 
8ER 180 
OL INTER 
E SCU ED 
RY INTO 
INTO ALP 
FOR SPE 
LIBRARY 
OB TO BE 
MPL COMP 



CORD FIL 

BINARY 
CTIQN SE 

RANGES 
WEEN NOS 
ILE TO A 
QUIREMEN 

NAMES 
HARDWARE 
PRETER 
I TOR . 
ALPHABET 
HABETICA 
LLING MI 
INTO ALP 

PROCESS 
ILER . 



E TO OTHER FILES . 

FOR SCU . . . • . . 

T. ........ 

FROM A FILE . . . . 

SITES * * * * • * 

REMOTE SITE . . . 

TS FOR SES PROCS . 

SYSTEM SIMULATOR . 

ICAL ORDER * . * . 
L ORDER ...... 

STAKES * • * * * . 
HA8ETICAL ORDER 
ED AT A REMOTE SITE 
.......... 



13-14 

15-15 

10-2 

10-4 

14-19 

13-6 

13-18 

6-22 

6-21 

9-3 

14-28 

10-3 

5-22 

4-40 

3-17 

5-25 

13-16 

8-8 



4.6 TEMPCOR - MAKE TEMPORARY CORRECTIONS TO BASE ..... 4-32 

6.7 TIME - DISPLAY CURRENT TIME OF DAY ........ . 6-11 

9.3 TQ170 - NQS/170 TO NOS/170 INTERFACE FILE CONVERSION 9-7 
9.2 T0180 - NOS/170 TO SIMULATED NGS/VE FILE CONVERSION 9-6 

6.10 TQQLDQC - PRINT TOOL DOCUMENT ............. 6-15 

6.11 TOQLREP - LIST TOOL REPORT .............. 6-17 

3.4 TWOPAGE - PRINT TWO DOCUMENT PAGES SIDE BY SIDE . . . 3-19 

3.7 TXTCODE - RUN TXTCODE DOCUMENT PREPROCESSOR ..... 3-26 

3.8 TXTFORM - RUN TXTFORM DOCUMENT PROCESSOR ....... 3-27 

3.9 TXTHEAD - PAGE HEADING PROCESSOR ........... 3-28 



14.6 


UMIQUE 


14.14 


UNPACK 


16.5 


UPDATE 


14.3 


UPT0L0W 


6.13 


USSDQC 


6.14 


USSINFQ 


9.10 


VEGEN 


9.9 


VELINK 


13.6 


WHOMAIL 


5.9 


WIPEMEM 


4.11 


WIPEMOD 


5.10 


WIPULIB 


14.20 


XLIT 


4.12 


XREFMOD 



REMOVE ADJACENT DUPLICATE LINES FROM A FILE 14-11 

UNPACK TEXT FILE TO MULTI RECORD FILE .... 14-24 

UPDATE PROGRAM LIBRARY HITH CORRECTION SET(S) 16-1? 

CONVERT UPPER CASE TO LOWER CASE ...... 14-5 

GET USER SUPPLIED SOFTWARE DOCUMENT .... 6-19 

ACCESS USS INFORMATION ........... 6-20 

EXECUTE THE SES VIRTUAL ENVIRONMENT GENERATOR 9-18 

EXECUTE THE VIRTUAL ENVIRONMENT LINKER . • . 9-15 

DISPLAY LIST OF USERS KHO HAVE SENT MAIL . . 13-13 

DELETE MEMBERtS) FROM LIBRARY ....... 5-27 

DELETE MODULE<S> FROM BASE ......... 4-42 

DELETE MEMBERtS) FROM USER LIBRARY ..... 5-30 

TRANSLITERATE CHARACTERS ••••••.*.. 14-37 

CROSS REFERENCE OF A BASE ..••..•••* 4-44 



1-15 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 171 User's Handbook REV? AS 

1.0 INTRODUCTION 

1 . 6 £EQ£IL£.=.S£III^S.y£.IQyE-La£I4U£!i^IEQtiJl£MI 

A PROFILE is a file where you can place information about you and 
the things you're currently working on. Many SES procedures use 
information out of the PROFILE to set up defaults for frequently 
used things* such as the name of an object library. Having a 
PROFILE can save you much time since you don't have to code 
parameters for information that's already in the profile* 

If you want to have a profile* you should create a file called 
PROFILE which has the word PROFILE as the first line of the file* 
The most important and useful pieces of information to place in your 
profile are your 22SSSa£Sl» Sfcacafi ZUBk&L and ££flififii QUlti££« Thus* 
your initial profile should have (at least) the following in it* 

PROFILE 

\ passwor * * your .password* 

\ charge * 'your. char ge. number* 

\ project » f your. project. number 9 

An sail way to set up an initial PROFILE for yourself is to call 
the BuiLO PROFile tfiLQEEQE> procedure like this s 

ses.bl dprof 

BLDPROF prompts you for the most common items to be placed in your 
profile* In addition* it creates a MAILBOX for you. For 
information on the "mail" facilities of SES* see chapter 12.0 - 
"USER TO USER COMMUNICATIONS". 

SES supplies a procedure called IAF* which sets up defaults for 
particular terminal types* BLDPROF prompts for your terminal type* 
and places that information in your profile* For further 
information on IAF* see the IAF procedure description in the 
"miscellaneous useful goodies** chapter* 

BLDPROF will also ask you for your graphics terminal type which 
may be different than your usual terminal* Even if you use the same 
terminal for graphic (CAOSG) and non-graphic work* you should answer 
both requests. BLDPROF will ask additional questions about your 
graphics terminal - baud rate* hard copy available* and for 
TEKTRONIX 4014 Extended Graphics Module and synchronous or 
asynchronous. For further information on CADSG* see the CAOSG 
procedure description in the Structured Process Tools chapter* 

There are many other things that may go into your profile. These 
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are mainly concerned with source code maintenance and library 
management functions and so on* These other aspects of profiles are 
discussed in the chapters dealing with the specific subjects* 

Another useful thing that can go into a profile is SES directives 
that specify which procedure libraries* and wheret to search for 
procedures* The SEARCH directive is discussed in appendix A* 



COMPANY PRIVATE 



1-17 

COC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User's Handbook REV* AS 

1.0 INTRODUCTION 

i~Z~5iL£22£!;22£IL£2 N ~ A 5 BA I c S-i225*-— - — *,„—,» 
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Instead of running interactively* or "while you wait** at your 
terminal* many SES procedures can be submitted to run in the 
background as batch jobs. You do this by coding a fce.y. (batch or 
batchn or defer) which causes the framework of a batch job to be 
built around the specified procedure* then SUBMITS the file so built 
to NOS as a batch job. 

Using SES in this way is often very effective* especially where 
the job to be done uses lots of resources* 8y running the job in 
batch* you can proceed with your interactive session instead of 
havi ng to wait* 

For such procedures* the list of parameters described below are 

those which affect the running of the batch job* Note that these 

parameters are o.flly. applicable if you run the procedure in batch 
mode (that is* non-local)* 



jobun 



jobpw 



jobf inly 



(optional) JOB User Name to be used on the USER statement 
of the batch job* If you don't code the jobun parameter* 
the job is built with the user name of the current user. 
MfltS s that in some NOS sites* it is qq£ aassiklfi to 
SUBMIT a job to run under another user's account. The so 
called "secondary user" statment is disabled* If 
secondary user statements are disabled* and you try to 
submit a job for another account* you get lflaaad tt££l 



(optional) JOB Password to be used on the USER statement 
of the batch job* If you don't code the jobpw parameter* 
and there's no passwor variable defined in your profile 
(see the section on profiles)* SES asks you for your 
password in a similar manner to that of NOS. 



(optional) JOB FaMitY to be used on the USER statement of 
the batch job. If you don't code the jobfmly parameter* 
and there's no family variable defined in your profile 
(see the section on profiles)* the family name for the 
current user is used. 
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jobcn 



jobpn 



jobf I 



jobtl 



jobpr 



bin 



(optional) JOB Charge Number to be used on the CHARGE 
statement of the batch job* If you don't code the Jobcn 
parameter* and there*s no charge variable defined in your 
profile (see the section on profiles)* SES asks you for 
your charge number* 



(optional) JOB Project Number to be used on the CHARGE 
statement of the batch job. If you don't code the jobpn 
parameter* and there's no project variable defined in your 
profile (see the section on profiles)* SES asks you for 
your project number* 



(optional) specifies the JOB Field Length to be used for 
running the job* You don't normally need to code the 
jobfl parameter* since all the procedures which run in 
batch set the FL to the required value* If you want to 
specify the job field length as an o.fi£al number* you BUit 
add the (8) suffix to the number* because SES treats 
numbers as decimal unless told otherwise* 



(optional) specifies the JOB Time Limit to be used for the 
job* This is always the same for all procedures* namely 
2000(8). If you need more time for the job* you must code 
some value for the jobtl parameter* If you want to 
specify the job time limit as an afitai number* you lUSi 
add the (81 suffix to the number* because SES treats 
numbers as decimal unless told otherwise* 



(optional) specifies the JOB PRiority (that is* the P 
parameter on the N0S job statement)* If you want to 
specify the job priority as an actai number* you mst add 
the (81 suffix to the number* because SES treats numbers 
as decimal unless told otherwise* 



(optional) B.1U number parameter used at Sunnyvale 
Development Division to indicate which "bin 1 * the job output 
should go in* The bin parameter is coded In the form of a 
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string* for example s bin» l 7h». You can also define a 
userbin variable in your PROFILE (see the section on 
profiles)* so that the bin number is picked up 
automatically. SES generates a large print banner of your 
bin number on the front of the job output* and also places 
the bin number in the job name field of the job statement* 
If you don't code the bin parameter* and there f s no userbin 
variable defined in your profile* SES generates a bin 
number of NO-ID* which almost certainly guarntees that your 
job output ends up in the NOS/yO 8IN NUMBER bin* 

local or batch or batchn or defer : 

coding one of these (optional) keys determines the mode In 
which the procedure or job is to be run. Coding the local 
!&£¥. runs the procedure LOCAL to your terminal* or while 
you wait. Coding the batch [say, issues a SUBMIT with 
option B for the SUBMIT statement* Coding the batchn &&Z 
issues a SUBMIT with the N option for the SUBMIT 
statement. Coding the defer &&% DEFERS the job for after 
hours running. You can find all the gory details of the B 
and N parameters for SUBMIT in the NOS reference manual. 

nodayf or dayfile or df s 

this (optional) parameter applies to some of the 
procedures that can be run as batch jobs* Each procedure 
description (for procedures which can run as batch jobs) 
specifically mentions this parameter only if the procedure 
makes use of it* For those procedures that do use it* 
this parameter applies only if the procedure is run as a 
batch job (that is* non-local). If you don»t code the 
parameter at all* or if you simply code dayfile or df* if 
the job hits an EXIT statement due to errors* the job 
dayfile is dumped to a file called dayfile* which is 
placed in your catalog when the job terminates* If you 
code dayf i I e*f i I ename or df*fi!ename* the dayfile is 
placed in your catalog in a file of name filename* If you 
code the nodayf option* no dayfile is produced at job 
end* The diagram below provides a more graphical 
explanation of the interactions of the dayfile parameter. 
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Cadsd Qq 

£L££fi£lUL£ 



Aatiaa lakfiQ 



Nothing 



Job dayfile is dumped to file dayfile if any 
errors occur during the job* 



dayfile 
df lie* 
onl y 



or 



Job dayfile dumped to file dayfile If any * 
errors occur during the job. I 



* dayf i le»f i le.naie 
! or df»f lie. name 



Job dayfile dumped to file file_na«e if any * 
errors occur during the job* I 



nodayf k&Z 



Job dayfile is qq.£ dumped even If errors X 
occur during the job* * 

•• ■ — ' < — ♦ 



tidtfi * that only those procedures whose descriptions contain a 
reference to the parameters described above can be run as batch 
jobs. 



Example of Batch Usage 



A fairly widely used SES procedure is LISTMOD (which supplies a 
cross reference and a printout of the modules in a base - see the 
chapter relating to source text maintenance)* LISTMOD runs "while 
you wait" by default* and since it grinds* it»s much better to run 
it batch* like this : 

ses.listmod b*newdata# batch 

15.00.19. SUBHIT COMPLETE. JOBNAME IS AFTQBXT 
* JOB LISTMOD SUBMITTED 

This example shows a simple usage of LISTMOD run in batch by coding 
the batch fcay.* The example assumes that your password* charge 
number* project number and all are defined in your PROFILE as 
described earlier* The message is returned by NOS 5 it's the time 
of day that your job was submitted* and the so called job name* The 
last message about job submitted comes from SES. 
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1.7.1 PROFILE VARIABLES FOR CONTROLLING BATCH MODE 



SES procedures that can optionally run in batch mode may be 
controlled by the settings of certain variables in your PROFILE* 
This wakes it easier to use SES all round* since you don«t then have 
to supply the information every time you use a procedure* The set 
of diL£&£iy.£& below can be coded into your profile if you wish* 



PROFILE 
\ passwor 
\ charge 
\ project 
\ family 



•your. password* 
•you recharge. number 1 
•your. project .number * 
•your. f ami ly» 



passwor defines your password 



charge defines your charge number* 



project defines your project number* 



family defines your family name. 



Hfitfi s that If your validation on the system is such that you do 
not require a CHARGE statement in batch jobs or when you log in at a 
terminal* you should set the charge and project variables to null 
(empty) strings* This inhibits the generation of the CHARGE 
statement by SES for batch jobs* 
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PROFILE 

V passwor » »ASTERIX» 
\ charge « •OBELIX* 

\ project » *GETAFIX» 

That is an example of a minimal PROFILE. Here*s a typical PROFILE 
as it might be defined for a user at Sunnyvale Development 
Division : 

PROFILE 

\ passwor » *WABBIT* 

\ charge » fl 

\ project » fl 

V user bin ■ f 21 E 1 

\ myname » f Lorenzo Desmondo 0* v Hare* 

Note that the charge and project variables are set to empty strings 
- at the time of writing* SDD doesn't require CHARGE statements on 
NOS. 
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1.8 IUEQgttAIIXE-fl£SSAS£S-E ! M&-SEi-EM££QU&ES 



Many SES procedures are set up such that when they run "while 
wait** at the terminal* they output informative messages to tell 
what they're doing* The informative messages 
and Q&ffiSfl &£££ on the appropriate procedures* 
in the absence of any other information is 
output informative messages* Coding the nomsg 
messages* However* it is possible to establish your own default by 
defining a profile variable called msgctrl* The msgctrl variable 
can be defined in one of two ways s 



you 
you 

are controlled by isa 

The normal default* 

for the procedures to 

&£¥ suppresses the 



\ msgctrl * •*• 



this sets the normal default for informative 

messages to no messages* In order to obtain 

messages from procedures the msg j£e.y. must be 
coded on the procedure call* 



\ msgctrl « »SESMSG.* f 



this sets the normal default to output 
informative messages* To turn messages off* 
the nomsg &S* must be coded on the procedure 
call* 



The table below should give a more graphical idea of the 
interactions of the msgctrl variable and the msg and nomsg &£XS on 
the procedures* 



+ . , . , . , - + 

1 SEEIBEfi m ERflEILE 1 

+ _ 4.4. 4. . + — , 4. 

5 (Lasted QO J! Nothing ? \ MSGCTRL^'SESMSG**' i \ MSGCTRt*»*« 3 

5 E£fl££$hl££ S S 2 3 J 

+ ... — 4.4. .4. , , 4. .- + 

3 Nothing J! Messages * Messages 3 No Messages * 

4. - _ 4.4. 4. . — 4. - ___-4. 

3 MSG !! Messages 3 Messages * Messages 3 

4.. , 4.4. 4. , , 4. 4. 

3 NOMSG 3? No J No Messages J No Messages 3 

* !! Messages 3 * 3 

♦ — +♦• + ■ ■ + ■ + 
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1,0 INTRODUCTION 

1.9 GENERAL NOTES ON SES PROCEDURES 



1 . 9 fiEBE&AL-iaaiES-QiLSES-e&flCEQliafcS 

SES procedures are* in general* written to 4o the detail work for 
you* so you can concentrate on the job at hand. Let's look at the 
workings of a typical SES procedure - £QEX ASCII Coded gecord 
<C0PYACR)» to see what it does : 

ses.copyacr I* input.fi le* o«output.f i I e 

* END COPYACR INPUT.FILE -> OUTPUT.FILE 

The COPYACR procedure emits NOS control statements to do the 
f ol I owing s 

a&gui££ the input.fi le (see the note on ACQUIRE below) 

aCSliiCS the program (tool) that does the COPYACR process 

£fiiil£Q the output.fi le 

CQEXACS. from input.file to output.fi le 

naiUHQ the COPYACR program 

LSttiQd both the input.file and the output.fi le 

you may if you wish* use procedures such as COPYACR like this s 

ses*copyacr fi I e. to.be. processed 

* END COPYACR FILE.TO.BE.PROCESSED 

In such cases* where does the output of the procedure go? Well it 
certainly doesn't go to file output (the terminal)* In such cases* 
the output file eventually replaces the input file s 

££gujx£ the f i I e. to. be. processed 
a£fllii£S the COPYACR program (tool) 

CQ£XA£B fi le.to.be. processed to a un igue.named.temp.fi I e 
££til£Q the COPYACR program 
* LfiQaOJS f i I e. to. be. processed * uni que. named. temp. f i le 
LfiMiud unique_named.temp.fiie 

There are many SES procedures that function this way - they are 
often referred to as FILTERS - a process that copies an input to an 
output with some Cone would hope* useful) transformation in 
between* 
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When you call up an SES procedure to * 

ses.do.some. process i»input_file* o»output_f i te 

one of the control statements emitted by the procedure is a 
statement to ACQUIRE the input.fi le» which means J 

1. if there f s a LQC&L file of the required name* g£HIfciO that file 
and use it as the input.fi ie. 

2. otherwise AIIACft or ££I a permanent file of the required name 
from the current user f s catalog. 

All this means you don't have to care whether or not files are 
local - SES procedures grab whatever is available under that name - 
that is what ACQUIRE is all about. There is a full description of 
the ACQUIRE utility in Appendix £. 

The foregoing has some interesting effects which you should be 
aware of however. Consider the following sequence s 

ses.files; catlist 

WORK... ...12 PT. 

CATLIST OF WCN < 9 FILES* 2685 PRUS 1 
MAILBOX I SP A ...1 OLDUSER D PU R 1127 PNTSORS PD R .105 
PROCLIB SP R .124 PROFILE I PR R ...1 PROGLIB PU R .835 
SEVEN.. I PU R ...2 STATSES PU W .485 USERDIR I PU R ...5 

* END CATLIST 

ses.pack i*statses 

* END PACK STATSES 

ses.fi I es 
WORK .12 PT. STATSES ..481 LO. 

* END FILES 

Note that we PACKed file STATSES. Note that originally* STATSES 
was a PERMANENT DIRECT ACCESS file. By the time the PACK process 
finished however* the PACK procedure (because of the RENAME process 
described earlier J has now left a LOCAL file of the same name. SES 
procedures don»t* in general* rewrite permanent files* Those that 
do say so explicitly. 
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1.9 GENERAL NOTES ON SES PROCEDURES 



If you followed the description of the behavior of SES procedures 
above* you may take note that SES is designed primarily as an 
XMIES&JLII2E tool. You sao ase SES in batch job streams If you wish* 
li ill you should be aware that SES procedures don't* in general* make 
a special case of files I&EUI and QUIEIJI* whereas NOS dass make a 
special case of files IUEUI and QUIEUI» Usually* «hen using SES 
procedures interactively* you don't use QUIEUI as the output file 
from procedures* those procedures that &q use IMEUI or &UIEUI say 
so* and take special note of those files* All this means that if 
you run SES in batch streams* and use files IMEUI or QUIEUI as input 
or output to procedures* you're likely to lose a lot of output 
because SES procedures REMITS or EEIUEfci things. So* to avoid grief* 
uses files other than X8EUI and QUIEUI* 



U&i9U£Jiat£&.ia_£££_DX0.£&£|u£e.s 

When SES builds the JCL stream from an SES procedure* programs* 
scratch files and so on are usually given unique names* so that you 
don't have to care which names are reserved by each particular 
procedure* These SES generated unique names are always seven 
characters long* always begin with the letters ZQ* and are always 
guaranteed to be different from the name of any file currently 
assigned to the running job. This note is for your information* 
just in case you ever look at a dayfile where SES procedures have 
been used* and see lots of funny looking names. The example below 
shows the JCL generated by the ses.Hmits procedure. 

SRFLC200Q0) 

$IFCFUE<0UTPUT»ASI)$RENAM£IZQWT8Q6»QUTPUT> 
$ASSIGN(MS, OUTPUT) 

»| TMTT C 

$RENAMECZQWT8QQ*OUTPUTJ 

$IFCFILECZQWT8Q6»ASil$RENAME{QUTPUT«ZQMT8Q61 

$REWIND(ZQWT8RA) 

EDTC ZQWT8QQ* ZQWT8RA, ZQWT8RW) 

$RETURNCZQWT8RA*ZQWT8RW> 

$C0PYBR<ZQWT8QQ, OUTPUT) 

$RETURNCZQWT8QQ) 

SRFLtO) 

* END LIMITS 
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1.10 PROCEDURE DESCRIPTION CONVENTIONS 



1.10 &&aCEaU&E.a£SC£I£IIQli-CQfiWEtlIIQMi 

The regaining chapters of this handbook describe SES procedures 

that are currently available* Each procedure description contains a 

list of parameter descriptions! and the order in which the 

parameters are described specifies their positional significance 
within the procedure. 

Only those procedures that make reference* in their parameter 
lists* to the "batch job parameters" (see section 1.7 - *SES 
PROCEDURES RUN AS BATCH JOBS") can in fact be run as batch jobs. 

If a procedure description does not contain a description for a 
parameter* that procedure does not have such a parameter. 

If a parameter description does not explicitly specify that a 
parameter is optional then the parameter must be supplied when the 
procedure is called. 

In order to reduce redundancy within procedure descriptions* some 
of the features provided by a procedure are discussed in the 
descriptions of particular parameters* therefore* we strongly 
recommend that when you read a procedure description* you read the 
whole thing. 

Before you read a particular procedure description* we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptions* profile usage* and naming conventions are 
discussed in those subsections. 



COMPANY PRIVATE 



1-28 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User's Handbook REV* AB 



1.0 INTRODUCTION 
1.11 HELP HQDE 



1.11 ttELE-HQQE 

SES provides a mode of operation of procedures that produces 
descriptive information about the specified procedure* The 
information includes a one or two sentence description of what the 
procedure does plus a list of the parameters* their defaults* and 
the permissable values. In addition* required parameters are 
"flagged" with IR) and defaults that are controllable by PROFILE 
variables are "flagged" with an *« To get the help documentation 
for a procedure listed out on your terminal* you simply type s 

ses* he I p. procedure. name 

Notice that no parameters are given. SES responds by displaying the 
help documentation for the named procedure I if any is available). 
For example • 

ses*hel p.cybi I 
produces 5 

CYBIL compiles CYBIL source using either the CC or CI compiler. 

Parameters ares 

PARAMETER DEFAULT ALLOWABLE VALUEIS) 

i*f COMPILE filename 

I LISTING filename 

b LGO filename 

cc»ci *CC*SES keyword*username 

chk N»R*S n*r*s or no 

lo I of »o*i*m*w*r 

debug*d»nodebug NQDEBUG keyword or <ST*DS) 

pad none 1 •• large reasonable number 

opt or 1 (CI only) 

msgtnomsg *MSG keyword 

-HELP FOR CYBIL ON FILE OUTPUT- 

MtttS : that help mode is not intended as a training mechanism or 
a tutorial for new SES users - that's what this SES User's Handbook 
Is for - help mode is there as a "memory jogger" for more 
experienced SES hackers* 
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1.12 PRE-RELEASE VERSIONS OF TOOLS 



1.12 £&£ = a£LE4i£-mSiaHSLQE-iaaLS 

SES provides a convenient and consistent method for accessing 
pre-release versions of SES supplied toots* To access the 
pre-release version of a procedure* you simply type s 

ses* sss.procedur e.naie i ist_of_par ameters 

If there is a pre-release available for the specified tool* it 
executes* If there is no pre-release version* you get the standard 
release version* 

If you always want pre-release versions of tools that are 
available* you can place in your PROFILE the following directive : 

\ SEARCH* USER* SSS* SESUNAN 

This tells SES to first look in the current user's catalog for the 
specified procedure (just as normally happens)* then look in the 
pre-release catalog (SSS)* and finally look in the standard release 
catalog (specified by the SESUNAN variable}* 

A more detailed description of the SEARCH directive can be found 
in appendix A* 
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1.13 PROBLEM REPORTING 



1.13 £SQaU&-&E£0£IIM£ 

Problems encountered while using a released SES tool should be 
reported using a PSR (Programming System Report* CDC form AA1901). 

Problems encountered while using a pre-released SES tool should 
be reported using a PTR (Programming Trouble Report* CDC form 
AA3385I. 

In both cases the completed form along with all support materials 
should be sent to the Arden Hills PSR Coordinator (ARH273K 
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1.14 APPLICABLE DOCUMENTS 



1.14 AEELI£AaL£-fifl£y!5£8I$ 



The following Is a list of documents describing the various tools 
supplied by SES. tdfitfi s that SES provides a procedure called 
TQOLDOC which provides "on-line** access to many SES documents. If 
you call TOOLDOC Mittmut ailiQfl aQX E3£aifit£tS» you get a list of 
the available DCS documents. 



+ .. + — , — + . 

Ver * Document Type ? DCS Number * Updated 



*-« 



Tool 



SES 
SES 
EDT 

ACQU 

EXTR 

SESM 

TXTC 

TXTF 

TXTH 

6ENR 

CADS 

CADS 

CY8I 

CY8I 

CYBI 

CYBI 

CYSI 

Sim. 

C180 

C180 

SES 

SES 

C070 

C180 

PSEU 

SCU 



Too Is 

Processor 

IRE 

ACT 

SG 

ODE 

ORM 

EAD 

EVP 
DD Tool 
Graphic 

L 

L 

L 

L 

L 



Tool 



Formatter 
Debugger 
I/O 
NOS/VE I/O 
CPU Asmb. 
PPU Asmb. 
VE Linker 
VE Generator 
OCU 

Simul ator 
DO 
(170) 



« — - 


— . » 


? 1, 


,1 J 


1 2« 


► I 


1 1* 


.5 \ 


5 1* 


► o ; 


J 1, 


,0 s 


\ 2, 


► J 


? 2, 


,0 \ 


I 0, 


► o \ 


J 1, 


,0 J 


; i, 


► ? 


5 1. 


► J 


\ 2, 


,2 J 


\ 2. 


► 4 \ 


? 1, 


,1 I 


I 2.0 I 


\ 5, 


.0 J 


\ 3, 


.0 1 


8 1« 


► J 



User 

User 

See 

See 

See 

See 

User 

ERS 

See 

See 

User 

User 

Lang 

I.D. 

ERS 

ERS 

ERS 

ERS 

ERS 

ERS 

ERS 

ERS 

ERS 

ERS 

User 

ERS 



Handbook 

Guide 
SES U.H. 
SES U.H. 
SES U.H. 
SES U.H. 

Guide 

SES U.H. 

SES U.H. 
Handbook 
Handbook 

uage Spec 
Handbook 



Guide 



ARH 1833 
ARH 2894 



ARH 2893 
ARH 1737 



ARH 
ARH 
ARH 
ARH 
ARH 
ARH 
ARH 
ARH 
ARH 
S25 
ARH 
ARH 
ARH 
ARH 
ARH 
ARH 



3980 
3981 
2298 
3078 
2619 
3142 
2739 
3125 
1693 
01 
2816 
2591 
2922 
1729 
2892 
1766 



07/31/81 
05/29/79 



02/21/80 
06/01/77 



03/ 
03/ 
06/ 
06/ 
05/ 
09/ 
07/ 
01/ 
02/ 
03/ 
02/ 
02/ 
07/ 
03/ 
05/ 
05/ 



30/81 
30/81 
18/81 
18/81 
14/81 
29/80 
18/80 
25/80 
18/80 
07/78 
18/80 
18/80 
18/81 
02/81 
29/79 
21/80 



SES U.H. 
SES P.W.G. 



refers to this document 



refers to the SES 
to above as the SES 



Procedure Writer's Guide (referred 
Processor User Guide — ARH 2894) 
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1.14 APPLICABLE DOCUMENTS 



The following CDC manuals for NOS/170 may be of help to users of 
SES* 



60435400 NQS Version 1 Reference Manual (Volume 1) 

60445300 NOS Version 1 Reference Manual (Volume 2) 

60455250 Network Products Interactive Facility Version 1 
Reference Manual 

60435500 NQS Version 1 Time-Sharing User's Reference Manual 

60450100 NQS Version 1 Modify Reference Manual 

60492600 COMPASS Version 3 Reference Manual 

60328800 SrMPL Reference Manual 

60497800 FORTRAN Extended Version 4 Reference Manual 

60429800 CYBER Loader Version 1 Reference Manual 

60481400 CYBER Interactive Debug Version 1 Reference Manual 
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3.0 DOCUMENT FORMATTING SYSTEM 

3 * 4 IiiQ£AfiE. = .Eail4I.IiQ.ttaCUaEt4I,EAfiES.iia£- W.SID£ 

TMQPAGE takes the output of any of the text processors and places 
two output pages on one printer page» This reduces both paper usage 
aajj print time* which is invaluable while documents are in their 
development stages and being turned around fast. 

The Input for TWOPAGE must be in 8 of 12 ASCII format and aflt in 2 
NOS 6/12 ASCII. Its output is also in 8 of 12 ASCII. Parameters to 
TWOPAGE are : 



I or f 



name of Input £ile to be processed by TWOPAGE* 



(optional) name of Qutput file from TyGPAGE* If you don»t 
code the o parameter* the output appears on a file of the 
same name as the input file specified by the i parameter. 



ptf or width s 

(optional) £age M*dth of the output pages. If you don*t 
code the pw parameter* TWGPAGE uses a default page width of 
137 (136 columns plus one column of carriage control). 
Remember to cater for the carriage control column when 
specifying the page width. 



seq 



this (optional) fce.^ indicates that l£Quence numbers are to 
be placed on the final printout. The sequence numbers 
appear down the center of the printer page between the two 
document pages. Default action in the absence of the seq 
Kay. is no sequence numbers. 
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la£s£iaaJi.E£a£ass-ffi£_U£da£iaa-a_aasa-££jaii£a£v. 

When updating a base or library you can interlock the update so 
that only one user at a time can update the base or library* Those 
procedures that update a base or library are set up so that if the 
base or library to be updated is in another user*s catalog* the base 
or library is interlocked by default. You can override default 
actions by defining a lokmode variable in your profile* or by coding 
a lock or nolock key. on the procedure* as shown In the diagram on 
the next page* 

Interlocking of a base or library is done via an interlock file. 
Such a file aas.1 be a QIRECI access file in tb& Saifi y*££l& cataiaa 
IS th& kasa a£ iifc£a£l feaiOS JiaiiatasJ* Naturally the interlock file 
must be a PUBLIC* WRITE MODE file if other users are likely to be 
using it* The default name used by the SES source code maintenance 
and library management procedures for the lock file is intrlok. You 
can have an interlock file of any name by defining the intrlok 
profile variable* or by coding a file name as a value for the lock 
parameter on the appropriate procedures* 
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4.1 GETMOD OR GETMODS - EXTRACT MODULE GROUP ™Q* m *£l* m „ mmmmmmmmmm „~ 

(optional) is a file containing a CGRrection Set to be 
applied against the base b before the module m is 
extracted. If you code this parameter* SES procedure 
TEMPCGR is used to apply a TEMPorary CORrection set. Note 
that TEMPCQR doesn't actually alter the base* the 
correction set is only applied for the duration of the 
GETMOD(S) run. 

w or width s 

(optional) maximum Width of modules retrieved. 

status or sts : 

status is an (optional) parameter that can be used for 
those cases where GETMOD(S) is being used as a building 
block of more sophisticated procedures or jobs* The 
status parameter causes GETMOD(S) to set one of the job 
control registers to the value zero if GETMQD(S) 
successfully completed* and to non zero if anything went 
wrong during the run of GETMOD(S). The only values that 
may be coded for the status parameter are one of Rl» R2* 
R3 or EF. Any other value coded causes an error message 
to be output* and the GETMOD(S) procedure aborted. 



msg or nomsg : 

these (optional) k£¥& control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Examples of GETMOD(S) Usage 

ses.getmods (outlind* I imi tsd. . opr typk* ststypk* symentd. .symk ) 
* END GETMODS GROUP <- BASE 

This example shows GETMODS used to extract a bunch of modules from a 
base. Modules outlind* all modules llmitsd through oprtypk* module 
ststypk* and all modules symentd through symk are extracted. Every 
parameter to GETMODS is set to its default value* The modules 
appear on the file group. 
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4.5 GENCQR OR GENCORS - GENERATE CORRECTION SETS 



id 



(optional) IDent name for the GENCORS *IDENT directive in 
the generated correction set* id can be any character 
string that forms a valid MODIFY correction identifier* 
If you don't code the id parameter* GENCORS generates a 
unique correction set identifier* 



sf 



this (optional) parameter specifies the name of the file 
containing the new version of the module* If you don't 
code the sf parameter* GENCOR(S) uses the name specified 
by the m parameter as the Source File name* 

Is or ignorls s 

these (optional) fce.y.5 specify whether or not to IMQSe 
Leading Spaces on lines being compared* The default action 
is to recognize leading spaces (the Is option)* If you 
code the ignorls lsfiy.# GENCORCS) ignores leading spaces on 
text I i nes* 



fl 



(optional) parameter to increase the field length* If you 
don't code the £1 parameter* GENCOR(S) defaults to a field 
length of 100K. 



msg or nomsg : 

these (optional) K&1S. control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES"* 



Example of GENCORCS) Usage 

ses.gencors m*nlce* b*neat. un*by73. nc»corset 

* GENERATING CORRECTION SET FOR NICE ON CORSET 

* END GENCORS NICE -> CORSET 

This example shows a correction set being generated for module 
nice. The original module is in base neat in the catalog of user 
by73. 
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4.9 LISTHOD - LIST CONTENTS OF BASE 



4 * 9 LI£I8QQ-r-Lm-£Q!ai£!iI$-Q£..M$E 

i 

LISTHOO performs two main functions s to show you what's |n a 

base* and to get a printout of the modules in the base \ if 

necessary* LISTHOO first generates a cross reference of the base* 

showing which modules call which modules* and which modules are 
called by which modules (LISTHOO uses procedure XREFHOD to generate 

the cross reference - see the description of XREFHOD if you're 

interested)* Lastly* LISTHOO generates a printout of all modules or 

common modules in the base— you can suppress this if you only want 

the cross reference without the whole base's contents* Parameters 
to LISTHOD are s 



b or I 



o i 



(optional) name of Base to be processed* If you don't 
code the b parameter* LISTHOO uses the value of profile 
variable base* and if there's no such variable defined* 
LISTHOD uses the default name base* 



(optional) name of file to receive the Output from 
LISTMOD* If you don't code the o parameter* a scratch 
file is used for the output and is returned once it has 
benn printed* If you code the o parameter and LISTHOO is 
run in local mode* the output is placed on the specified 
file and is nat printed unless the print parameter is 
given. 



(optional) User Name in whose catalog the base specified 
by b is to be found* If you don't code the un parameter* 
LISTHOD uses the value of profile variable baseown* and if 
there's no such variable defined* LISTHOD uses the user 
name of the current user. 



batch job parameters : 

These parameters are described in section 1*7 - M SES 
PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in batch mode* but It can be run in J 
local mode* The dayfile parameter is not used by this ! 
procedure* 
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4.0 SOURCE TEXT MAINTENANCE 

4.9 LISTHOD - LIST CONTENTS OF BASE 



print 



(optional) Indicates how the output of LISTHOD is to be 
printed. For the print parameter you may code any of the 
parameters to procedure PRINT. If you don f t code the 
print parameter at all* LISTMOD prints one (1) copy of the 
output on the ASCII printer. 



short or common 5 

these (optional) KfilS control which modules are listed 
following the cross reference of the base* If you omit 
this parameter* LISTHOD lists the source for all modules 
In the base. If you code the common &SY* LISTHOD lists 
only the common modules from the base. If you code the 
short &£!# no modules are listed (i.e.* only the cross 
reference is produced). 



Examples of LISTHOD Usage 



ses.listmod pr Int-cop i es*3> short 

11.17.34. SUBMIT COMPLETE. JQBNAME IS AVQPBUG 
* JOS LISTHOD SUBMITTED 



This example shows LISTHOD processing the base whose name is 
contained in profile variable base. Three copies of the short list 
(cross reference only) are produced. LISTHOD is run in batch* 
rather than interactively. Running LISTHOD in batch is the 
preferred mode* since it uses rather a large amount of resources. 



ses.listmod b»cidbase« o*ci dpr i n#..«. • 

••? pr int*(copies*2» h»* I atest/version of/cidbase 9 ) 

10,19. 57. SUBMIT COMPLETE. JOBHAME IS ACULBXG 
* JOB LISTHOD SUBHITTED 

This example shows LISTHOD run in batch to produce two printouts 
of the cross reference of base cidhase* plus the text of all the 
modules in cidbase. 
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5.0 LIBRARY OR MULTI RECORD PILE MANAGEMENT USING LI8EDIT 

LISTMEM performs two main functions to show you what's in a 
library* and to get a printout of the TEXT members in the library If 
necessary* LISTMEM first generates a normal CATALOG which shows the 
names of all the members in the library. Lastly* LISTMEM generates 
a printout of all TEXT members in the library - you can suppress 
this if you only want the catalog without the whole library's 
contents* Parameters to LISTMEM are * 



I or b 



(optional) name of Library to be processed* If you don't 
code the b parameter* LISTMEM uses the value of profile 
variable lib as the library name* and if there's no such 
variable defined* the LISTMEM uses the default name lib* 



(optional) name of file to receive the Output from LISTMEM 
places the output on some unique file name that it 
generates* The output doesn't default to file output 
because* if you're running LISTMEM interactively* you 
probably don't want the rather voluminous output on the 
screen* 



(optional) User Name in whose catalog the library 
specified by I is to be found* If you don't code the un 
parameter* LISTMEM uses the value of the value of profile 
variable libown* and if there isn't such variable defined* 
LISTMEM uses the user name of the current user. 



batch job parameters : 

These parameters are described in section 1.7 - W SES 
PROCEDURES RUN AS BATCH JOBS"* The default for this 
procedure is to run in batch mode* but it can be run in 
local mode* The dayfile parameter is not used by this 
procedure* 



un 



print t 



this (optional) parameter indicates how the output of 
LISTMEM is to be printed* For the print parameter you may 
code any of the parameters to procedure PRINT* If you 
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don't code the print parameter at all* LISTMEM prints one 
CD copy of the output on the ASCII printer* 

short i 

if you code this (optional) &£i* LISTMEM only generates 
the catalog output* and suppresses the listing of all the 
TEXT members. 



Examples of LISTMEM Usage 

ses.listmem print*c*3 short 

12.34.56. SUBMIT COMPLETE. JQBNAME IS ACULARS 
♦ JOB LISTMEM SUBMITTED 

This example shows LISTMEM used to process a library* whatever 
name is the value of lib* Three copies of the short list (catalog 
only) are being produced* LISTMEM is being run in batch* rather 
than interactively. 

ses.listmem b*procllb o*procs pr int*fc«2*h« f latest/procl lb 1 1 

18.12.90. SUBMIT COMPLETE. JQBNAME IS ANAPABS 
* JOB LISTMEM SUBMITTEO 

This example shows LISTMEM being run in batch to produce two full 
printouts of the catalog and all the TEXT members in the library 
proclib. The title on the listing is Matest proclib 1 . 
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6.0 GETTING INFORMATION 



6.o sfciiiM-iiiEaRMiioa 



This chapter describes a collection of SES procedures to find out 
what»s going on and that's available. There are two wain areas of 
interest s 

1. Information about your local environment on NOS - what files 
you have* your validation limits* the time* parts of your 
dayfile* and others* 

2. Information about SES - documents* procedures and status* 

CATLIST display comprehensive information about files in a user's 
catal og. 

CATALOG gives a condensed list of the records in a library. 

PERMIT gives permission information for files in a useMs 
catal og* 

FILES display information about focal files* 

T00LD0C prints documents describing tools 

TOOLREP displays status and problems for a specified tool or 
product. 

INFO displays the latest information about SES* 

USSOOC gets User Supplied Software document. * 

USSINFO displays the latest information about User Supplied J 
Software* 5 
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DAYFILE displays a selected part of your dayftle. 

LIMITS displays your LIMITS information in a condensed format. 

DISPLAY displays various information about your job environment 

TIME "talks** the current time as a dayfile message. 

DAYWEEK tells you what day of the week a date fell on# falls on 
{that is» today)* or Mill fall on. 

SESPROC generates a list of names of SES procedures. 

SESPARM generates a printout of the parameter lists of SES 
procedures in any selected procedure library. 
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6.10 T03L0QC - PRINT TOOL DOCUMENT 



6.10 IQaLaQ£-::-££IfclI-IQaL-QQ£US£fciI 

TOQIOOC is the means by which on-line and/or off-line copies of 
TOOL DOCupents are made available. Parameters to TOOLOOC are i 

docs or d : 

This {optional) parameter is used to indicate which 
documents) you wish to obtain. Document names are taken 

from the "document number" column of the document index 

display {see the •doclist 1 parameter). The absence of this 

parameter will default the proc to display the entire 
document index. 

docl ist or dl s 

{optional) used to indicate that the document index is to 

be displayed - or retained on a file named by the Misting* 

parameter. The "doclist* parameter is ignored if the 

•docs* parameter is specified. Specific portions of the 

document index are displayed by using the following keys 

with this parameters 

CY8IL - CY8IL Compiler related documents. 

C170 - SES Development and Support tools other than those 

for C180 Project. 
C180 - C180 Operating System development documents. 
OTHER - Documents that don*t fit into the categories 

above. 
SITE - Documents available only at the local user f s site. 
ALL - All of the above categories. This is the default 

if none of the above keys ^re indicated* 

listing or I s 

{optional) name of file to receive the iiacuifiat iQd£X 
diSSlax {when using TOQLDOC without specifying any 
document(s ) )f at the formatted document(s) themselves. If 
you code the listing parameter to direct the documents) or 
the document index to a file* that file is not printed. 



bin 



{optional) ftlfcl number used at Sunnyvale Development 
Division to indicate the bin number the output is to go 
to. If you don't code the bin parameter* TOOLDOC uses the 
value of profile variable userbin* and if there's no such 
variable defined* generates a bin number of NO-ID. 
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6,10 TOQLDQC - PRINT TOGL DOCUMENT 



Note that the standard SES batch job parameters are available* 
The default Is to run the job In batch mode* 



Exaaple of TQ0L00C Usage 

ses.tooldoc arh2739 

10*36*10* SUBMIT COMPLETE* JGBNAME IS AAEOAXA 

* JOB T00L00C SUBMITTED 

This example would cause the ERS for CY8II I/O to be printed on 
the system line printer* 

ses.tooldoc l»doclist 

* INOEX DISPLAY -> DOCLIST 

* T00LD0C DISPLAY COMPLETED 

This example copies the document index to the file DOCLIST. 
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6.11 TOOLREP - LIST TOOL REPORT 



6.11 IQQU££-=-.UH.IQQL-E££QEI 



TOOLREP provides a 
outstanding problems for a 
TOOLREP are ? 



display of the current 
specified tool or product. 



status and/or 
Parameters to 



tool or t : 

specifies for which tool or product a report is desired* 
Currently* the qqLy. supported values for the tool parameter 
are SIM180 (the CYBER 180 Hardware System Simulator)* CYBIL 
<CYBIL compilers)* and SCU (Source Code Utility). 

status or problms J 

if one of these (optional) Issxs is coded* only that portion^ 
of the report (status or outstanding problems) is 
displayed. If you don f t code either of the &£¥.£» both 
portions of the report are displayed. 



( opt i onal ) 
TOOLREP. If 
goes to file 



name of 
you don't 
OUTPUT by 



file to 
code the 
def aul t. 



receive the 
o parameter* 



Qutput from 
the output 



Examples of TOOLREP Usage 



ses.toolrep siml80 status 



This example of TOOLREP displays the current status of the CYBER 
180 Hardware System Simulator. 



ses.toolrep scu 



This example of TOOLREP displays the current status of the NOS 
170 version of the Source Code Utility and known problems with the 
utility. 



COMPANY PRIVATE 



6-19 
CDC - SOFTWARE ENGINEERING SERVICES 

7/30/81 
SES (Release 17) User*s Handbook REV: AB 

6,0 GETTING INFORMATION 

6.13 USSOOC - GET USER SUPPLIED SOFTWARE DOCUMENT 

6.13 USiflQa.r-fi£I-USEB-SU££LIEQ-SQ£IMA&£.aaCUflEtiI 

USSDOC is the means by which on-line copies of User Supplied 
Software documents are made available* Parameters are * 



product or pr s 

This (optional) parameter is used to indicate which 
document you wish to obtain* Document names are the same 
as the product itself. The absence of this parameter will 
default the proc to display a catbase listing of what Is 
available on the document file. 



listing or I s 

(optional) name of file to receive the document you wish to 

retrieve* If you don't conde ths I parameter* the output 

appears on file LISTING* 

Example of USSDOC Usage 

SES. USSDOC PR*GET L-LISTQUT 

* END USSDOC GET -> LISTOUT 

This example retrieves documentation on GET to the file LISTOUT. 
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6.14 USSINFO - ACCESS USS INFORMATION 



USSINFO is a means thereby users may get up to the minute 
bulletins on changes in User Supplied Software* 
USSINFO are s 



o or output : 

(optional) name of file to receive the output 
USSINFO. If you don't code the o parameter* USSINFO \ 
outputs the USSINFO file to OUTPUT. I 
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6*0 GETTING INFORMATION 

6*15 SESPROC - LIST SES PROCEDURE NAMES 



6.15 S£S££Q£-=-Uai-S£S_£&a£EJHl££-MA!3££ 



SESPROC displays a list of procedure names already used by SES* 

This is of use if you are a procedure writer and wish to create new 

procedures for use in SES* You can then use SESPROC to ensure that 
there isn't any name conflict* Parameters to SESPROC are s 



un 



(optional) list of user names whose catalogs are to be 



searched for procedure libraries* SES uses 
Library NAHe as the name of the procedure library 
for* If you don't code the un parameter* SESPROC 
the names of procedures in the PR0CLI8 of the 
user* and the names of procedures on SES library* 



the SES 
to look 
displ ays 

current 



o or 



output : 

(optional ) name 
SESPROC. If you 
file output* 



of file to receive the Output from 
don't code the o parameter* SESPROC uses 



Example of SESPROC Usage 



ses.sesproc un«ed73 
UN * ED73 

CETGEN COLLOOC 
ICGEN MOVDOC MQVSUB 
RELSUB REPDOC REPSUB 

* END SESPROC 



COLLSUB 

PERT 

SENDKC 



EDTOOC 
PRTOOC 
WIPEDQC 



EDTMOD 
PRTSUB 
WIPESUB 



EOTSUB 
RELOOC 



This example 
procedures in the 



shows SESPROC used to determine the names of SES 
PROCLIB of user ed73* 
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6.16 S£S£A&a-=«££ltiI.ElAaAll£IER-&EflUIS£ll£tlIS-£Q&.SES-eRflCS 

SESPARM prints out the parameter definitions for all the 
procedures on a library. It runs batch or local with batch as the 
default. Parameters to SESPARH ^re ? 



name of Library whose parameters are to be printed. 



un ? 

(optional) User Name where the library is to be found. If 
you don't code the un parameter* SESPARH assumes that the 
library is in the catalog of the current user. 

o or output or listing s 

(optional) name of file to receive the Output of SESPARIi. 
If you don't code the o parameter* the output appears on 
fi le LISTING. 

batch job parameters i 

These parameters are described in section 1.7 - M S€S 
PROCEDURES RUN AS BATCH JOBS'*. The default for this 
procedure is to run in batchn mode* but it can be run in 
local mode. The dayfile parameter is not used by this 
procedure. 

print s 

(optional) parameter to control the PRINTing of the 
output. When the job runs in batch* one copy is printd 
automatically. If you run the procedure in local mode* no 
copies are printed* unless you specifically code some 
print parameter. For example* you could code pr lnt*c*3 to 
obtain three copies of the parameter listing. The format 
of the print parameter is that of the parameters for the 
PRINT procedure. 

Mate that the parameter list of each procedure iusi terminate 

with a PARMEND directive* or* for those records in a library which 

don't have a PARHEND directive by virtue of the fact that they're 

INCLUDE files* the parameter list must be terminated by a 
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6.16 SESPARM - PRINT PARAMETER REQUIREMENTS FOR SES PROCS 



PARMENO " 



Example of SESPARM Usage 



ses.sesparm l»proclib un»hk77 local noprint 

DEBUG 



\ 


PARM KEY 


* tf » 




NVALS « 1..MAXVALS 


NAM 


\ 


PARM KEY 


* l , args , » 


•a*) 


NVALS » I 


STR 


\ 


PARM KEY 


* tp* 




NVALS * 1..MAXVALS 


NAM 


\ 


PARM KEY 


« a 1 f 




NVALS * 1 


NAM 


V 


PARM KEY 


« ^e 1 




NVALS * 1..MAXVALS 


STR 


V 


PARM KEY 


* 'xld* 




NVALS * 1..MAXVALS 


STR 


\ 


PARMEND 










at* 


«*S*3S« 










OBUGFTN 










V 


PARM KEY » 


CM** »f«) 


NVALS 


» 1 NAM 




\ 


PARM KEY * 


•M 


NVALS 


» 1 STR 




\ 


PARM KEY » 


• b* 


NVALS 


» 1 STR 




\ 


PARM KEY * 


•lo« 


NVALS 


» 1 NAM 




\ 


PARMENO 











* END SESPARM PR0CLIB/HK77 -> OUTPUT 

Although this Is a rather contrived example of a procedure 

library with only two procedures in lt# It illustrates the output 

that SESPARM generates* SESPARM is run in local mode* or while you 
wait* to produce the parameter definitions for procedures in library 

proclib in the catalog of user hk77* The noprint &£y. Inhibits 
printing of the generated output* 



The diagram on the next page shows the alternative forms of 
parameter definitions of SES procedures* Alternative forms are 
arranged in the vertical columns* The blocks of text below provide 
a brief description of each field of a parameter definition. 
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6.0 GETTING INFORMATION 

6.16 SESPARM - PRINT PARAMETER REQUIREMENTS FOR SES PROCS 



\ PARM KEY * <«Kl»*«K2V*...*Km NVALS 

keyword 
V / \__, / \ 



This command starts 
the definition of an 
SES PARaMeter* 



KEY specifies the key- 
word or keywords that 
may be used when coding 
a parameter for an SES 
procedure. 



NAM 

NUN 
■■ min..max STR REQ RNG 

number FGN 
... _/ \_/ \_/ \_/ 



NVALS specifi 


es the Number 


that may be co 


ded for a par am 


form mln..max 


indicates tha 


of *min* values* and a maximu 


values may be 


coded. If only 


is specified* 


it means that t 


max are the same. If NVALS 


value of zero 


COIt then it 


that there may be no values 


that the parameter keyword is 


option key. 


NVALS specifie 


indicates that 


the keyword ma 


as an option 


* or that it m 


values. 





of VALues 

eter. The 

t a minimum 

m of "max" 

one number 

he min and 

specifies a 

i ndicates 

coded* and 

used as an 

d as 0..max 

y be used 

ay be gi ven 



This field indicates the parameter type. It may 
be NAMe* NUMber* STRing* or ForeiGN text. Refer 
to the INTRODUCTION section for a description of 
parameter types. 



<- — ♦ 



If this field is coded 
description* it indicates 
REQuired* and therefore may 



in the parameter 
that that parameter is 
not be omitted. 



<~ 



If this field is coded in 
description* then it indicates 
valuetsl may be coded as a RaNGe* 
form first.. last 



the parameter 

that parameter 

that is* in the 






\ 

\ 
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8.0 COMPILING* LINKING* AND DEBUGGING 

8.1 CY8IL - RUN CYBIL CC OR CY8IL CI COMPILER 



the SES» This is done by coding as a value for this 
parameter the user name of the owner of the compiler 
you f re after. For example* entering cc*lp3 accesses the 
version of the CC compiler residing in the LP3 catalog* 
It is necessary for the owner of such a compiler to use 
the file name CY8ILC for the CC version and CY8ILI for the 
CI version in order to allow the compiler to be accessed 
via this procedure. 



chk 



this (optional) parameter specifies the run-time checks 
the compiler is to generate. If you code afi for this 
parameter* no run-time checking code is generated. If you 
code any combination of q (check for de-reference of NIL 
pointer)* £ (check value ranges— range checking may add as 
much as 3 1/2 words to the generated object code for each 
range check performed) and s (check subscript ranges)* the 
corresponding checking code is generated and omitted 
checking options cause the corresponding checks to be 
suppressed. If you omit the chk parameter* CYBIL 
generates all flavors of run-time checks. 



lo 



this (optional) parameter specifies the Options to be used 
when producing the Listing. Any combination of the 
following designators may be coded for this parameter J 

a specifies that a map of the source input block 
structure and stack is to be produced 



specifies that a full listing is to be 
(selects list options S* A* and R) 



produced 



o specifies that the listing should include the generated 

object code in an assembler-like format 

s specifies that the listing of the source input file is 
to be produced 

w specifies that the listing of warning diagnostic 

messages is to be suppressed 

r specifies that a symbolic cross reference listing is to 
be produced 

ra specifies that a symbolic cross reference listing of 
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8*0 COMPILING* LINKING* AND DEBUGGING 

8*1 CYBIL - RUN CYBIL CC OR CYBIL CI COMPILER 



all program 
referenced or 



ent I ties 

not 



i s 



to be 



produced 



whether 



x works in conjunction with the LISTEXT pragmat such that 
LISTtngs can be EXTernalfy controlled via the compiler 
cal I statement* 



If qs is specified* 
parameter is omitted* a 
only is produced. 



no 1 Is t i ng 

I 1st ing of 



is produced* If the lo 
the source Input file 



debug or d or nodebug : 

this (optional) parameter 
options to be in effect 
available debug options are 



is used to select the debug 
for the compilation. The 



sd If this option is selected* the compiler includes 
Symbol Table information in the object code file to 
be used by the CY8IL interactive debugger* If this 
option is not selected it isn»t possible to 
symbolically debug the moduie(s) being compiled* 

fd This option produces the same tables as d»sd plus 

stylizes the generated code to provide a step 

facility when using the symbolic debugger (it is only 

meaningful* currently* when used with the CC 
compi I er) • 

ds If this option is selected the Debugging Statements 
appearing between ?? nocompile ?? and 
?? compile ?? pragmats is compiled* otherwise such 
statements are skipped by the compiler* 

If you omit this parameter or you code the nodebug &£*.* 
none of the sd# fd or ds options are selected* If you 
code the debug or d &£y,s but don't code any values* 
debug*sd is used* To select combined options you can code 
debug»(sd*ds) or debug* ( fd* ds) . 



pad 



coding a numeric value for this (optional) pad parameter 

generates the specified number of no-ops between machine 

instructions* This feature is used for the P3 
di agnostics* 
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opt 



this (optional) parameter is used to select optimization 
levels in the (CI SQly.) generated code* Legitimate values 
are : 

Provides for keeping constant values in registers* 

1 Provides for keeping local variables in registers. 

2 Eliminate redundant memory references* 



msg or nomsg s 

these (optional) Ilsis control the generation of 
informative messages by this procedure and are fully 
described in section 1.8 - "INFORMATIVE MESSAGES FROM SES 
PROCEDURES". 



Example of CYBIL Usage 

ses.cybil lo* , or*» chk^sn 1 

* END CYBIL COMPILE -> LISTING, LGO 

This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE. A listing is produced consisting of 
the source input* generated object code* and a symbolic cross 
reference, on file LISTING. The object code is written to file LGO 
and will include run-time checking code for Subscript ranges and NIL 
pointer de-reference. 
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9.1 SittlflQ.=.aUll-IUE-CXftE&-iaQ-ttAafiiiA&£-StSIEll.SWULAIQR 

SIM180 runs the CYBER 180 Hardware System Simulator (often 
referred to as the HSS). The hardware system that is simulated 
consists of the following components J 

1. CPU 

2* Central Memory C16 Megabytes) 

3* 10(10) Peripheral Processors (PPs) 

4. 12(10) I/O Channels 

5* 2 7154 disk controllers sharing 4 844-4x disk storage 

units* 
6. 2 7155-1 disk controllers sharing 2 844-4x and 2 885-lx 

disk storage units* 
7* 2 7155-14 disk controllers sharing 2 844-4x» 2 885-lx 

and 2 885-42 disk storage units. 

SIM180 sets up the total system simulated environment and gives 
control to the CY8ER 180 simulator* At this point* the user may 
enter any valid simulator command (refer to document ARH1729 - 
"CYBER 180 SIMULATOR ERS W for command descriptions)* Simulator 
commands provide the user with control over the simulated 
environment which includes the following capabilities 5 

1. CPU and PP memory loading 

2* Interpretive CPU and PP instruction execution 

3. CPU and PP breakpoint 

4* CPU and PP trace 

5* Display and change Central and PP memories 

6* Dump Central and PP memories to a specified file 

7* Display and change CPU and PP registers 

8. Checkpoint / Restart 

9* On/off CPU and PP simulation 

10. CPU keypoint 

11* CPU program performance monitoring 

The CYBER 180 simulator Is intended primarily for interactive use 
(local mode) but may be readily used in batch* An example of batch 
submission of a Simulator run is given below* Parameters to SIM180 
are * 



restart or rs * 

(optional) name of a checkpoint file from which to restart 
simulation. The checkpoint file may be one previously 
created by GENCPF ((iterate £heck£oint fcile). VEGEN 
(Virtual Environment ££fcJerator)> or via the simulator 
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CHECKPOINT command* If you don't code the restart 
parameter* a complete simulated system Is created. 



cf : 

(optional} name of a command file which is to be processed 
Immediately upon activation of the simulator. The command 
file consists of one or more valid simulator command(s). 
This parameter Is required when running in batch. 

1180 or i : 

(optional) name of file containing input for the special 
simulator CPU I/O instruction iop code FF(16)). If you're 
running SIM180 interactively and don't code the il80 
parameter* SIM180 takes Its Input from a file assigned to 
your terminal* If you run SIM180 in batch and use the CPU 
I/O instruction for input* you must supply a file 
containing the input. 



ol80 or o 2 

(optional) name of file to receive output from the special 
simulator CPU I/O Instruction (op code FF(16)). If you're 
running SIM180 interactively and don't code the ol80 
parameter* SIM180 sends output to a file assigned to your 
terminal. If you run SIM180 in batch* you must supply a 
file to receive the output* otherwise the output is lost. 



Examples of SIM180 Usage 

ses.siml80 

** I SM 6052: CYBER 180 SIMULATOR VER 6.4 LEV 126 (MIGDS REV SI 

This example shows SIM180 used interactively* to create a new 
simulated system environment* The user may enter any simulator 
command once the simulator banner Is displayed. 

ses.slml80 rs*checkl cf»errata 

** I SM 6052: CYBER 180 SIMULATOR VER 6.4 LEV 126 CNIGDS REV S) 

This example shows SIM180 used to resume simulation from a 
checkpoint file. The command file errata is processed before 
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requesting additional simulator commands from the user. 

ses«siml80 checkx i*indata o»outdata 

** I SM 60525 CYBER 180 SIMULATOR VER 6.4 LEV 126 IKIGDS REV SI 

This example shows SIM180 used interactively* to resume 
simulation from the checkpoint file checkx. The special simulator 
CPU I/O instruction* when encountered during CPU instruction 
simulation* is to read input from file indata and is to write output 
to file outdata. 

ses.do batchn* f i I e* s i mcf * • . . . • 

• •? csM f ses«siml80 postds* cf»slmcf* o»progout « * . ... . 

• •? •save*sesl og f I 

15.54.28. SUBMIT COMPLETE. JOBNAME IS AAAQCBN 

• JOB 00 SUBMITTED 

This example shows SIM180 submitted for batch running via the SES 
00 procedure. Simulation will resume from the checkpoint file 
postds* the simulator commands in the file simcf are processed* and 
any output from the special simulator CPU I/O instruction is 
directed to file progout. Refer to the description of the SES 00 
procedure in the "Miscellaneous Useful Goodies" section for an 
explanation of using DO to submit multiple control statements to 
batch. 
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9.13 ££ILQa.r.ACi2yiE£.fiI!i4EX.£QS-£tiiI£*-.IMI i .lQA2£g 

GETLD8 acquires the absolute binary to run the HCS Environment 
Interface loader. There are no parameters. 



Example of GETLDB Usage 



ses.get I db 

* END GETLDB VGENLDB IS LOCAL 
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13.0 SES COHMUNICATIONS 



Each mainframe lias been assigned a site identifier. These site 
identifiers are ? 

ARH - Arden Hills 176 S/N 101 
SVL - Sunnyvale 176 S/N 112 
AS2 - Arden Hi I 1s S2 

tiatfi * As additional systems are added to the network* they are 
assigned a site identifier. 

In addition to the site-id* each user must have a valid user 
name* password* charge number and project number for the target 
machine. These may be coded into your PROFILE. The PROFILE 
variables are created by concatenating the site-id with , fam f for 
family name* •use* for user name* 'pas 1 for password* 'cha* for 
charge* and »pro f for project. Users may have PROFILE variables for 
each remote mainframe they are validated to run jobs on. In 
interactive mode* the remote link procs requests the family name* 
user name* password* charge* and project variables if they are not 
in your PROFILE. 

Bate * taat ia aatsa amds* £as satiaais tas£ asisi ia *aax EEQEIL£» 
at ias iaa aaatts* 

EXA8£L£ s The variables needed for a Sunnyvale user to run jobs 
on the Arden Hills S2 would be s 

user name* 

password 9 " 

charge number 1 

project number* 

family name 1 



PROFILE 






\ AS2USE 


» *your 


S2 


\ AS2PAS 


» f your 


S2 


\ AS2CHA 


» f your 


S2 


\ AS2PR0 


« *your 


S2 


V AS2FAM 


* • your 


S2 



If the value for a remote site charge parameter is set to a null 
string (for example SVLCHA - » •)* the remote link procedures omit 
the CHARGE statement in the job control statement stream that is 
sent to the remote mainframe for execution. 

If a remote site family name is set to a null string (for example 
ARHFAM * •*)* the family parameter isn f t specified on the USER 
statement. 
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14.0 TEXT MANIPULATION AND CONVERSION UTILITIES 

14.15 CQti^-=-CflM^£gI.CaM4CI£a.a£I 

CONV converts text files from one character set to another. NOTE « 
- Due to its flexibility* the conversion process is fairly time 1 
consuming. Parameters to CONV are s 1 

i or f s 

name of the Input File contains text to be converted* 

o : 

(optional! name of the file to receive the Output from 
CONV. If you don't code the o parameter* the output 
appears on the file specified by the i parameter. 

incset or ic : 

designator for the INput ft I e * s Character SET* See the 
table below for a description of the allowed designators. 

outcset or oc : 

designator for the OUTput file's Character SET. See the 
table below for a description of the allowed designators. 

The following table defines the designators allowed for the 
incset and outcset parameters: 

Sssiaaatar. asauiaa 

N63 NOS 63 6-bit codes 

N64 NOS 64 6-bit codes 

N612 NOS 6/12 ASCII 6-bit and 12-bit codes 

N612U same as N612 except that all letters are upper 

case 

N612L same as N612 except that all letters are lower 

case 

N8E63 NOS/BE 63 6-bit codes 
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N8E64 N0S/8E 64 6-bit codes 

N8E63A NOS/BE ASCII 63 character subset 7-bit codes (5 

per word) 

NBE64A NOS/BE ASCII 64 character subset 7-bit codes C5 

per word) 

ASCII4 full ASCII 7-bit codes (4 per word) 

ASCIIS full ASCII 7-bit codes (5 per word) 



A table of these characters sets can be found in an appendix to 
this document* 
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i4, i6 i^Eaati-^ca^^&i-iEUdia-aQUECE-iQ^iiiEflE^soaECE 

JABFORM converts source for the TEXTJAB document formatter to 

source for the TXTFORM document formatter* JABFORM only works on 

TEXTJAB source format directives that are delimited* Parameters to 
JABFORM are 8 



i or f 5 



o t 



name of the Input File containing the TEXTJAB document 
source* 



name of the file on which the TXTFORM source is written 
Out* Mats that unlike many other SES procedures JABFORM 
doesn't overwrite the Input file with the Output file. 



e : 

(optional) name of the file to receive error messages from 
JABFORM* If you don't code the e parameter* JABFORM uses 
file ERRLIST. 

A complete description of the conversions performed by JABFORM 
can be found in an appendix to this document. 
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15.0 MISCELLANEOUS USEFUL GOODIES 

15.1 I4E.=.a£I-yE.IIiIIUL-IA£-I£Saiti4L.£Aa4li£I£Ri 

The IAF procedure defines your terminal to the NQS IAF facility. 
In addition* it will notify you of MAILBOX messages* and updates to 
SES. INFO. 

There are defaults for all the different terminal types* and 
normally* the user only specifies his/her terminal type either on 
the proc call or in his/her PROFILE. All the strange parameters* 
including the terminal type* may be set up in your profile. As an 
example* if you're togged in to a CDC 713 terminal* you can set up 
the terminal controls by simply typing J 

ses.iaf term«cdc713 



The table on the next page describes the parameters for IAF* the 
defaults* and the profile variables that you can set to change the 
defaults chosen by the IAF procedure. 

lists s while the IAF procedure is running* da Qfit hit carriage 
return <CR) to find out what's going on* even if it does seem a 
little slow. At the time of writing* due to the way the NOS TRMDEF 
command works* hitting a carriage return interferes with the TRMDEF* 
which will issue a line of garbled data to your terminal* and the 
TRMDEF command gets ignored. In other words* the IAF procedure 
won f t do anything. 
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15*0 MISCELLANEOUS USEFUL GOODIES 

15*1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



* • It 
t 1 II 

* EaLM£t£L • Dfitault ! Etafils * Eatatstat 

* Mai£ < ¥aiys < SteciatiJLs * Usaas 

« term* t 1 No Default J term * Terminal type* For a 
X J ! J list of the terminal 

* * XX types currently 
J * * » recognized by the IAF 
S « • * procedure* see the list 
! J J 'at the end of this 
! X X {table. 

5 Intchr* Ic * see below J intchr ' character to INTERRUPT a 

* « J * process* 


* termchr* tc • see below * termchr * character to TERMINATE a 
5 X X X process* 


5 canchr* cc 5 see below X canchr * character to CANCEL a 
* X X * 1 ine input at the 
\ X J J terminal* 


1 conchr* ct * see below X conchr X character to use as a 
I X XX CONTROL character when 
J J * * giving commands <such as 
J 5 ! ! page wait on or off) to 
X I X X the TIP* 


* half/full X full X duplex * determines whether your 

X X XX terminal is to run in 
J S XX HALF or FULL duplex* 

• ' XX These are just &&XS* 


S ci 5 J ci X Carriage return idle 

X X \ count for IST3 or TI745. 


X li • X li * Line feed idle count for 
X X XX IST3 or TI745. 

* hardcpy X no * hardcpy X If you use a hardcopy 
X X XX device on your IST3* the 
X X X 1 defaults for ci and li 
X X XX are changed to 50 each* 



The defaults given above* namely W IAF default* 1 * are those chosen 
by IAF <part of N0S)» as opposed to IAF (the SES procedure)* We 
have copped out by not stating what they are here* since they change 
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15.0 MISCELLANEOUS USEFUL GOODIES 

15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



from time to time. For a list of the defaults* consult the IAF 
reference manual* or see your local NOS wizard. 

The tern (for terminal) profile variable is set up when you use 
8LDPR0F <BuiLD PROFile)* and the IAF procedure uses this profile 
variable* If you use the IAF procedure and no terminal type is 
specified* either via the term parameter or the term profile 
variable* IAF prompts for the terminal type. You can edit your 
profile to insert ail the other defaults if you wish. 

Terminal types that the IAF procedure knows about at present 
are : 

CDC713* CDC751, CDC752, DX132A* NCR620, TI745, TTY43* DECW3, 
TEK4Q14, IST3. 
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15.0 MISCELLANEOUS USEFUL GOODIES 

15.1 IAF - SET UP INITIAL IAF TERMINAL PARAMETERS 



The table below describes the control characters and other 
parameters that the IAF procedure establishes for you. &&&£ * that 
a page width of zero CO) allows the maximum page width. 



>— ™- ~+ 4— — » 4 —4. , — + __ + , — . . 4., _ + 

3 TERM- 3C0NTR0L J CANCEL J INTER- 3 TERM- SPAGE J PAGE JECHQ- 5 
3 INAL 3 CHAR J CHAR 3 RUPT 3 INATE 3WIDTH5 LENGTH IPLEX 3 
3 TYPE 3 J 3 CHAR 3 CHAR J 3 '.MODE I 

s j * 3 * s * s * s ; * s s 

4.-, —4. , —4— ■ 4- -— + + + — +■ ■ -♦ 

5 C0C713 3 ESCAPE 5 LINE J STX 3 ETX JO ! 16 3 FULL 3 
J 3 I CLEAR s 3 3 J s ; 

4_, -.4.™ — ™ — 4— -4 -4 — -._-, 4 -4 — -* ; — 4 —4 

« • * • * •* <• 

3 C0C751 5 ESCAPE 3 GS 3 CTRL/P 5 CTRL/T 10? 24 5 FULL 5 

4 «. — 4* 4— 4. » 4.-. -—4 -4 _ «. 4 .4 

3 CDC752 5 ESCAPE 3 CTRL/X 3 CTRL/P 3 CTRL/T SOS 24 S FULL 3 

4— 4 ™ 4 • 4 — 4 4 4-. + __ . 4 

S DX132A 5 Z 5 CTRL/X S CTRL/P S CTRL/T S 132 S 30 3 FULL S 

4 4— • 4 — , 4 4 4 4^ 4 4 

3 NCR260 S S 1 S S S S3 

S TI745 } J J S ! S ! S 

S TTY43 S ESCAPE J CTRL/X S CTRL/P 3 CTRL/T 3 3 N/A 3 FULL 3 

3 DECW3 3 3 3 3 3 3 3 3 

3 TEK40143 3 3 3 3 3 S3 

3 IST3 3 3 3 3 3 3 3 3 



The default values can be changed by coding a parameter that 
corresponds with one of the columns marked with *. If half duplex 
is desired* simply code the half fc.£2» 

Watfi 2 when specifying an octal code to change a default value* 
remember that the radix* enclosed in parentheses* must follow the 
number* for example : 

conchr»33(8) 
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17.0 $I&U£IU£Ea-£RQ££S£-niQi.S 



CAQS-=-aQHEUIS£-Ua£a-a£UM-Q£.£QEIMME 

The structured process tools are a set of Data Dictionary 
utilities and a Computer Graphics Design tool. They support the 
Structured Analysis/Structured Design (SASD) methodology used for 
development of software. 

CADSG creates or updates DFD> SCT and DSD diagrams used in the 
SASD methodology. 

CADSGUT lists or edits diagram title blocks. 

DDCREAT creates a data dictionary. 

DDDIS displays the contents of a data dictionary. 

DDHERGE merges the contents of two data dictionaries Into a single 
data dictionary. 

DDXREF prepares a cross reference listing of a data dictionary. 

DOXCHK checks a data dictionary for consistency. 
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The Computer Graphics Diagram tool supports the Data flow Diagram 
<DFD)* Structure Charts <SCT> and Data Structure Diagram (DSD). 
These diagrams can be created* printed* saved* recalled and updated 
using a TEKTRONIX 4014 or IST-III Graphics Terminal. Other 
terminals will be supported in later versions. See the "Applicable 
Documents" section of this document for the manual that supports the 
CADS Graphics. 

The Data Dictionary Utilities provide a set of creation* 
updating* checking ^n6 printing functions. Version 1.2 consists of 
CREATE* DISPLAY* HERGE* XCHECK and XREF functions. Later versions 
will also contain an EDIT function. See the "Applicable Documents** 
section of this document for the manual that supports the Data 
D ict i onary . 
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17.0 STRUCTURED PROCESS TOOLS 

17.1 CADSG - CREATE OR UPDATE SASO DIAGRAMS 



17.1 Uai£-=-CS£m-Q&-UEaAI£-SASQ-mGg&l$ 

The CADS Graphics tool* CADSG* supports the creation and 
maintenance of Data Flos* Diagrams (DFDI* Data Structure Diagrams 
(DSD) and Structure Charts (SCT1* These diagrams are the primary 
diagrams used in the SASD technique. See the SASD GRAPHICS USER'S 
HANDBOOK* ARH3981* for details of this tool. Parameters to CADSG 
are s 



ntfok 



(optional) name of the file to be used as the current 

notebook. If you don't code this parameter* CADSG uses the 

value of the profile variable ntbk* and if there's no such 

variable defined in your profile* then CADSG uses the 
f i lename N0TE8K. 



newntbk : 

(optional) name of the file to be used as the new 
notebook. If you don't code this parameter* CADSG writes 
the notebook back to the current notebook file (see ntbk 
parameter ) • 



term 



(optional) name of your terminal type* TEK4014 or IST3. If 
you don't code this parameter* CADSG uses the value of the 
profile variable term* and if there's no such variable 
defined In your profile* then CADSG will ask you which 
terminal type you have* 



baud i 

(optional) baud rate you are running with your terminal. 
If you don't code this parameter* CADSG uses the profile 
variable baud* and if there's no such variable defined In 
your profile* then CADSG will ask you for your baud rate. 



hardcpy s 

(optional) do you have a hardcopy device attached to your 
terminal? YES* NO* Y or N. If you don't code this 
parameter* CADSG uses the profile variable hardcpy* and If 
there's no such variable defined In your profile* then 
CADSG will ask you if you have a hardcopy device. 
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eg» 



(TEK4014 only* optional) do you have the Extended Graphics* 
Module, EGN, on your TEKTRONIX 4014 terminal? YES, NO, Y 
or N. If you don't code this parameter for the TEK4014, 
CADSG uses the profile variable egm, and if there's no such 
variable defined in your profile, the CADSG Mill ask you if 4 
you have EGH. 



sync 



(TEK4014 only, optional) are you running synchronous or 
asynchronous? A or S. If you don't code this parameter 
for the TEK4014, CADSG uses the profile variable sync, and 
if there's no such variable defined in your profile, then 
CADSG will ask you which you are running. 

If the file name does not exist or is empty, a new notebook is 
created. Use the NEW command within CADSG (see SASD GRAPHICS 
USER'S HANDBOOK ARH39811. 



Examples of CADSG Usage 

SES. CADSG, NT8K»MYB00K, NEWNTBK*NYNEWBK 

* BEGINNING CADSG ON MYBOOK 

( Interactive session with CADSG ) 

* END CADSG NOTEBOOK MYBOOK — > MYNEVfBK 
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17.2 CADSGUT - LIST OR EDIT DIAGRAH TITLE BLOCKS 

17,2 CAQiaiiI.--LISI.Qg.£QII^I2IASE4M-IIIL£«aLQCliS 

The CADSGUT SES procedure for R1.2 provides a utility for 
complete or partial listing of the notebook file diagram title 
blocks and/or replacement of fields within these titles* 

The call format is: 

SES. CADSGUT* ntbk*pf nl»newn tbk*pf n2* LIST 



ntbk 



(optional) name of the file containing the diagram 
records. If this value is not specified* the procedures 
will use the value of profile variable ntbk as the input 
file name. If no variable is defined* CADSGUT uses the 
name NOTEBK as the name of the input diagram file* 



newntbk : 

(optional) name of the file to which the edited and/or 
converted diagram records are written* If this variable is 
not specified* CADSGUT uses the default name NEWNTBK as the 
name of the output file. 



list : 

If list (optional) is specified* CADSGUT performs an 
SES.PRINT of the complete diagram title information from 
all diagram records contained on the input file* 
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17.3 OOCREAT - CREATE A OATA DICTIONARY 



17.3 a&£a£4I-r-£££AIE_4-QHA-ai£IIQMRI 

The DDCREAT function takes a user text input file and creates a 
Data Dictionary COD) file. Parameters to DDCREAT are s 



(optional) name of the file containing the source data for 
creating the DDm If you don't code the i parameter* then 
DDCREAT uses the value of the profile variable ddi» and if 
there's no such variable defined in your profile* then 
DDCREAT uses the filename DDTEXT. The i file is not 
rewound. 



new s 

(optional) name of the file onto which the new DD is to be 
written. If you don't code the new parameter* then DDCREAT 
uses the value of the profile variable ddnew* and if 
there's no such variable defined in your profile* then 
DDCREAT uses the file name NEWDD. 

Example of DDCREAT Usage 

SES. DDCREAT I«HYTEXT» NEli»MYNEWDD 

♦ BEGINNING 00 CREATE 

f Additional informative messages from DDCREAT ) 

* ENO DD DDCREAT MYTEXT > MYNEWDD 

This example shows DDCREAT used to create a new data dictionary* 
HYNEMDD* from the text in the source file NYTEXT. 
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17,4 QaaiS-=_aim4X-A-MIA-&UIIQMA&I 

The DDDIS function extracts entries from a data dictionary and 
writes them to an output text file* Extraction criteria are 
specified by directives on a directives file or by specifying a type 
key* (See Data Dictionary User's Handbook ARH3980*) Parameters to 
DDDIS are : 



old 



type 



(optional) name of an oid data dictionary file from which 
to display a text file* If you don't code this parameter* 
then DDDIS uses the value of the profile variable ddold* 
and if there's no such variable defined in your profile* 
then DDDIS uses the filename OLDDD* 



(optional) name of the file to receive the output from 
DDDIS in a form suitable for inclusion as 'asis' text in a 
FGRMATted document* If you don't code this parameter* then 
DDDIS uses the value of the profile variable ddo* and if 
there's no such variable defined in your profile* then 
DDDIS uses the filename DDTEXT* 



(optional) name of the file containing directives* in NOS 
ASCII line-image format* to the DDDIS processor. If you 
don't code this parameter* DDDIS uses the value of the 
profile variable ddd. If there's no such profile variable 
defined in your profile and a type key is not specified* 
then DDDIS accepts directives from your terminal or* In the 
case of a batch job* from the filename input* The d file 
Is not rewound* If you code the d parameter* don't code, a 
type key. 



(optional) &£* specifies a DDDIS directive keyword* 
Acceptable values for type are: ally allh* data* file* 
flow* cottpone* element* process* proch* nodule* action* 
actionh* dfd* dfdh* set* notype* and undef; don't include a 
backslash* Coding the type parameter is equivalent to 
specifying the directives *»\keyword \end w on a d 
(directives) file. If you code the type parameter* don't 
code the d parameter* 
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print t 

(optional) parameter to control the PRINTing of the output* 
o file* When the job runs in batch mode and there is no o 
file* one copy is printed automatically* If you run the 
procedure in local mode* no copies are printed unless you 
specifically code some print parameter* For example* you 
code prlnt»c*3 to obtain three copies of the parameter o 
file* The format of the print parameter is that of the 
parameters for the PRINT procedure* 

Example of OODIS Usage 

SES.OODIS* OLD-MYOLDDD. 0«LISTIT. D»D0WHAT 

* BEGINNING OD DISPLAY 

* 00 OISPLAY ACCEPTING DIRECTIVES 

( Additional DO / User Interaction I 

* END DD OODIS NYOLDOD > LISTIT 

This example shows DOOIS used to display selected entries from the 
data dictionary* NYOLDOD* The directives for selecting entries were 
read from the file DOWHAT* If this parameter had been omitted* 
directives would have been read from the file INPUT* The listing of 
formatted data dictionary entries was written to the file LISTIT in 
the order selected by the directives read from the file DOWHAT* 
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17.5 DDMERGE - HERGE TWO DATA DICTIONARIES 



17.5 &M£R&£-::-a£E££-IMQ Jim JU£UaK4RI£S 

The DDMERGE function combines two data dictionaries to produce a 
new one. Parameters to DDMERGE are : 



old 



new 2 



{optional) name of the old data dictionary file with which 
you wish to merge another data dictionary. If you don't 
code the old parameter* then DDMERGE uses the value of the 
profile variable ddoldt and if there's no such variable 
defined in your profile* then DDMERGE uses the filename 
OtDDD. 



(optional) name of the data dictionary file you wish to 
merge with the old data dictionary. If you don't code the 
m parameter* DDMERGE uses the value of the profile variable 
ddm» and if there's no such variable defined in your 
profile* then DDMERGE uses the filename merdd. 



(optional) name of the file onto which the new DD is to be 
written. If you don't code the new parameter* then DDMERGE 
uses the value of the profile variable ddnew* and if 
there's no such variable defined in your profile* then 
DDMERGE uses the file name NEWDD. 



replace s 

(optional) &gy. causes entries contained in the old data 
dictionary whose names are duplicated by entries contained 
in the m data dictionary to be REPLACE'd by the m data 
dictionary. The filename DDIOG will contain a list of 
duplicate entries and the action taken in each case. 

Example of DDMERGE Usage 

SES. DDMERGE* OLD*MYQLDDD» H»MERGEDD# NEH«HYNEWOD* REPLACE 

* BEGINNING DO MERGE 

♦ END DD DDMERGE MYOLDD ♦ MERGEDD > MYNEWDD 



This example shows the use of DDMERGE to combine entries from the 
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The DDXREF function produces a formatted cross reference listing 
of part or all of the old data dictionary file. Parameters to 
DDXREF are i 



old 



(optional) name of the old data dictionary file from which 
you want a cross reference listing. If you don't code the 
old parameter* then DDXREF uses the value of the profile 
variable ddold* and if there's no such variable defined in 
your profile* then DDXREF uses the filename OLDDD. 



{optional) name of the file to receive the output of ODXREF 
in a form suitable for printing on the ASCII printer. If 
you don't code the I parameter* then DDXREF uses the value 
of the profile variable ddlist. If there's no such 
variable defined in your profile* and you're running DDXREF 
LOCAL at your terminal* the output appears on a file called 
LISTING. The I file is not rewound. 



type J 

(optional) jsg* selects the type of entries you want to be 
included in the cross reference listing. Acceptable values 
for type are: flow* compone* element* file* data* process* 
module* dfd* set* notype* action* undef* and all* 



print 



(optional) parameter to control the PRINTing of the output* 
I file. When the job runs in batch mode and there is no I 
file* one copy is printed automatically. If you run the 
procedure in local mode* no copies are printed unless you 
specifically code some print parameter. For example* you 
code prlnt»c*3 to obtain three copies of the parameter I 
file. The format of the print parameter is that of the 
parameters for the PRINT procedure. 



Example of DDXREF Usage 



SES. DDXREF* I«MY0LDDD* L«LISTIT> ALL 
♦ BEGINNING DD XREF 
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17.0 STRUCTURED PROCESS TOOLS 

17,6 OOXREF - CROSS REFERENCE A DATA DICTIONARY 



(Additional informative messages from DDXREFI 
* END DD DDXREF HYQLDDD > LISTIT 



This example shows the use of DDXREF to obtain a cross reference 
listing of all sections of the data dictionary HYQLDDD* The cross 
reference listing will be on the local file LISTIT* Printed copies 
could have been obtained by adding the PRINT parameter* 
PRINTMC»3.H«*XLISTn. This will orint 3 copies with a header 
♦XLIST 1 . 
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17,0 STRUCTURED PROCESS TOOLS 

17.7 DDXCHK - CHECK A OATA DICTIONARY FOR CONSISTENCY 



17.7 QaX£Uli-=-£aE£li.A-QAIA,fiICLnQ14A&I-£Q&-£QaSi5iI£tlCX 



The DDXCHK function runs a cross check against a data 
dictionary. A formatted listing is produced which contains the 
names of entries which meet criteria selected by the check 
parameter. Parameters to DDXCHK are : 



old 



I .* 



check 



print 



(optional) name of the old data dictionary file you want 
cross checked. If you don't code the old parameter* then 
DDXCHK uses the value of the profile variable ddold* and if 
there's no such variable defined in your profile* then 
DDXCHK uses the filename OLDDD. 



(optional) name of the file to receive the output of DDXCHK 
in a form suitable for printing on the ASCII printer. If 
you don't code the I parameter* then DDXCHK uses the value 
of the profile variable ddlist. If there's no such 
variable defined in your profile* and you're running DDXCHK 
local at your terminal* the output appears on a file called 
LISTING. The I file is not rewound. 



(optional) &e.v. specifies the kind of consistency check you 

want run against the old data dictionary* Acceptable 

values for check are: undef* unref* noref* recur* and 
full. 



(optional) parameter to control the PRINTing of the output* 
I file. When the job runs in batch mode and there is no I 
file* one copy is printed automatically. If you run the 
DDXCHK procedure in local mode* no copies are printed 
unless you specifically code some print parameter. For 
example* you code prlnt»c*2 to obtain two copies of the 
parameter I file. The format of the print parameter is 
that of the parameters for the PRINT procedure. 



Example of DDXCHK Usage 
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SES. DDXCHKt I»HYQLDDD* L»LISTIT# FULL 

* BEGINNING DO XCHECK 

( Additional informative Messages from DDXCHK ) 

* END DO XCHECK MYQLDDD - > LISTIT 

This example shows the use of DDXCHK to perform a full cross check 
of the data dictionary NYQLDDD. The cross check listing will be on 
the local file LISTIT. Printed copies could have been obtained by 
adding a PRINT parameter. 
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El.G ACQUIRE UTILITY 



N*mode specifies the access mode desired for the file 
(READ or R — the default* WRITE or W» or EXECUTE 
or E)« If the file is local* the mode Mill not be 
changed. To insure the mode will be changed* the 
PQ parameter should also be specified. 

PW»pw specifies the permanent file's password 

PN*pn specifies the packname for the permanent file 

When ACQUIRE Is attempting an ATTACH or GET* if the file is busy 
or if a permanent file utility is active* the following message is 
issued and the request is retried i 

- WAITING FOR PFN*per manent.f i I e.name UN*user_name 

When ACQUIRE is attempting an ATTACH or GET* if an error is 
detected by PFM the following message is issued and ACQUIRE aborts t 

- ERROR WITH PFN»permanent_f i ie_name UN*user_na»e 

In both of the above cases* the designated message is preceded by 
a more specific message generated by PFN* 
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F1.0 EOT - ENHANCED VERSION OF NQS TEXT EDITOR 



F 1 . EM-z-Etia AUCEfl JtE&SIQU_QE-&Q2LIEXL.Eaiia£ 



EDT is an enhanced version of the standard NQS text editor 
C EDI Tl « EDT incorporates column searches* modified FIND and FINDS 
commands* Input and Output file and TAB specification on the EDT 
call* control over terminal interrupts* INPUT HOOE options* multiple 
entries on command tines* command buffers* permanent file functions* 
and miscellaneous other additions. 

User documentation can be found on TOOLDOC (SESD009)* 



F 1 . 1 ECI-CQaiSOJL-SIAIEtlEBI-EQ&MI 

EDT*Clfni1»Cifn23fClfn33*Ctab].Ccmdstrl 

Ifnl - name of the file to be edited 

Ifn2 - name of the file containing the editor commands 
(default » INPUT) 

if 0* an END command is executed after processing the 
commands in cmdstr 

if 1* commands are read from file INPUT after 
processing the commands in cmdstr 

ifn3 - name of the output file (default * OUTPUT) 

tab - tabset to be used by EDT 

cmdstr - editor Command String to be executed if Ifn2 * or 1 
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M1*0 MECHANISE FOR COLLECTING USER SUPPLIED SOFTWARE 
Ml. 2 MAKING US ER^SOFTWARE^AVAILASLE^THRQUGH SES 

are assigned LJSS numbered flies* and are Kept in the SES catalog* 
The source for user supplied software is collected onto a 
semi-private SCU PL called USSPL and kept in the SES catalog* If 
the author requests that it not be accessible* the source is kept in 
a private SES f I ie. 

The major advantage of maintaining user supplied software is the 
SES catalog is than any changes or new software are automatically 
sent to the sites receiving the regular SES updates* 



HI. 3 QQanySiIiI4IItlfi-.A^AILAaiLIIX-a£-yS££-SU££LI£Q.iQEI^AS£ 

An online directory (USSINFO) of user supplied tools is 
maintained on the SES catalog. This file contains a short 
description of the tool provided by the developer* This description 
is also circulated via the Advanced Systems Development Productivity 
Circle and/or the SES Tools Bulletin* 

Hard copy documentation supplied by the user is available from 
SES on request or online via TOOLDOC* 



Ml.* SUE£Q&I.Q£-iiS£E-SU££LI£a-aQ£I*A&E 

All corrections* improvements or other modification to user 
supplied software are the responsibility of the person supplying the 
software* SES does not support any user supplied software* 

If software supplied by a user is standardized (it becomes a SES 
supported productl it is removed from the user supplied category* 
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